Support

First open

• Open the disk image and drag LingMark to Applications
• Launch it; macOS says the app was downloaded from the internet and checked by Apple. Click Open
• If macOS refuses to open it at all, the download was interrupted: delete it and download again, then compare the SHA-256 on the download page

Requirements

• A Mac with Apple silicon
• macOS 13 or later
• Intel Macs are not supported in 1.0

Updating

Download the new disk image and drag it over the old copy in Applications. Your vaults and settings are untouched: nothing about them lives inside the app.

Where things live

• Notes are ordinary .md files in the folder you chose, in the subfolders you see in the tree
• .lingmark inside the vault holds the app's bookkeeping: the vault's name, per-note metadata such as favourites, and the Trash
• The Trash is .lingmark/Trash. Emptying it is the only thing that permanently deletes a note, and it asks first and says how many

A folder the app refuses

The whole disk, a whole volume, your home folder and its Library are not folders of notes, and the app says so rather than scanning them. A folder of more than 20,000 files is offered with a warning first. Choose a folder made for notes, such as one inside Documents.

"This folder has a half-written LingMark setup"

A .lingmark folder exists without its manifest, which is what an interrupted first open leaves behind. Move or remove that folder and open the vault again; your notes are not affected.

Two apps on one folder

Another Markdown app and LingMark can share a folder. Links, embeds, callouts, tags and attachment settings are written in the syntax the notes already use. Edits made outside LingMark are noticed and merged; where they cannot be merged, a conflict copy is written beside the note rather than either version being lost.

Rich or Markdown

View › Normal Editor and View › Markdown Editor switch engines for the open note; Settings sets the default. Editor, Split and Reader layouts are the three buttons at the top right of the window.

Find and replace

⌘F opens find and replace in the Markdown editor. The rich editor has no find of its own; the Edit menu says so on the row.

Keyboard shortcuts

Help › Keyboard Shortcuts opens the command palette (⇧⌘P), which lists every command beside its keys. Formatting uses the usual chords: ⌘B, ⌘I, ⌘K for a link.

Attachments

Where files land and how links are written follow the Files and links settings. Remove image takes a picture out of the note and leaves the file; Delete image asks first and goes to the trash your setting names.

Starting

File › Git: Initialize Repository makes the open vault a repository. File › Git: Clone clones one into a folder you pick. Publish to GitHub signs in with a one-time code and creates and pushes a repository.

Credentials

Tokens are kept in the macOS keychain. On first use macOS may ask you to allow LingMark to use them; Always Allow holds across updates because the app is signed with a Developer ID.

Conflicts

A merge that conflicts opens the merge editor: Current and Incoming with a Result, Accept, Accept Combination, Ignore and Remove per conflict, and Complete Merge when none remain. A note that still holds conflict markers warns before it is committed.