Editing & Markdown

Every Markdown note is plain Markdown under the hood — what you type is what gets saved to disk, rendered live as you go instead of shown as raw symbols.

Markdown syntax

***text*** is strikethrough here, not bold-italic. A line that is only --- is still a horizontal rule.

Task lists use -[ ] with no space between the dash and the bracket — that is the syntax the editor types and recognizes.

There is no math/LaTeX, footnote, callout, or embed syntax. See Limitations.

Headings that fold

Every heading can collapse the section beneath it — handy once a note gets long.

• Option+Z — collapse or expand the section your cursor is in
• Shift+Option+Z — expand every section in the note, or collapse everything if it’s already fully expanded
• Option+Cmd+Z — cascade-collapse ancestor headings one level per press (current, then parent, then grandparent…). Once fully collapsed, repeat to reopen from the outermost down

Folding is purely visual and fully undo-safe: delete a collapsed heading and everything hidden underneath it goes with it, but Cmd+Z brings it all back exactly as it was.

Lists and tasks

Turn the current line into a list — or cycle it to a different kind — with Cmd+L (forward) and Shift+Cmd+L (backward):

none → checkbox → numbered → bullet → none

Checkboxes in a Markdown note stay in that note. They do not appear in Task View, which only gathers tasks from boards.

Tables

Insert one with the /table slash command (below), then:

• Option+Enter — add a row
• Shift+Option+Enter — add a column
• Delete / Backspace — deletes the whole table, but only when your cursor is inside an empty one

Tables are resizable by dragging column borders.

Images

Paste or drop an image straight into a note. It’s saved as a real file in an images folder next to the note — not embedded as a data blob — so your vault stays a normal, inspectable folder on disk. Older notes may still use an attachments/ folder; both are treated as image storage, not as note folders.

Supported types include PNG, JPEG, GIF, WebP, SVG, BMP, and AVIF. In Markdown the image is a normal ![alt](images/filename.png) link.

You can also write a regular Markdown image that points at an https:// URL; those are not copied into the vault.

Links and wikilinks

Regular Markdown links ([text](url)) work as you’d expect for external URLs. For linking one note to another, use a wikilink ([[Note Name]]) instead — see Linking Notes for autocomplete, display text, aliases, and backlinks.

Settings → Editor can also suggest note links while typing, without waiting for [[. That is a separate toggle from wikilink autocomplete.

Find and replace

Works inside any Markdown note, board, or mind map.

Shortcut	Action
Cmd+F	Open Find
Shift+Cmd+F	Open Find & Replace
Enter	Next match — or replace the current match, in replace mode
Shift+Enter	Previous match
Cmd+Enter	Replace All (replace mode), or open the current match
ArrowDown / ArrowUp	Next / previous match
Escape	Close, and restore your cursor position

Word count

The editor can show character count, word count, and words-per-minute — toggle each from Settings → Editor, or jump there with settings: word. Select text and the counters switch to that selection. WPM is measured against time you were actually typing, not wall-clock time, so stepping away to think doesn’t tank the number.

Slash commands

Hit / anywhere in a note to insert something without leaving the keyboard:

• /time — insert the current time
• /date — insert the current date (format is configurable in settings)
• /table — insert a table; type a size like 4x7 (rows × columns) and it’s remembered as your default for next time

Custom slash commands are personal templates:

1. Type /, then a name for your command (letters, digits, -, or _ — no spaces), and hit Tab to open its editor.
2. Write whatever Markdown you want — a meeting template, a daily-note format, a set of links you paste in often.
3. To use it later: /, the name, then Enter or Space. Re-open the editor from the slash menu to change or replace one.

Custom commands are stored per vault in the app, not as files inside the vault folder. Copying the folder to another Mac (or cloning it with Git) does not bring them along.

Use the arrow keys to move through any autocomplete menu, for slash commands or otherwise.