The note editor
Title and description
Section titled “Title and description”The title is edited by clicking it: Enter saves, Esc cancels. An empty one shows as “Untitled”.
The description is a short line under the title, up to 240 characters; ⌘/Ctrl+Enter saves it. Next to it is a ✨ button — a background generation of the description from the note’s content. The icon spins while the job runs and the result drops in on its own.
Below sits a metadata line: created, changed, word count.
The toolbar
Section titled “The toolbar”Under the header is a toolbar grouped by purpose; on a narrow window the lower groups fold into a “More” menu.
- undo and redo — ⌘Z and ⌘⇧Z;
- heading level — a chip with the current level: paragraph and headings 1–6;
- text — bold (⌘B), italic (⌘I), strikethrough;
- lists — bulleted, numbered, and a checklist with a choice between a plain markdown checklist and a task block;
- blocks — quote, inline code, code block;
- media — insert link (⌘K: find an existing note, create one by name, or paste an external URL), insert image, insert table — either a plain 3×3 markdown table or a spreadsheet with formulas (.ytable), which lives as a separate file next to the note and is unavailable until the note is saved;
- diagrams — Excalidraw and Mermaid;
- links — “Find links in the text” on a saved note: a background pass over the text looking for connections to other objects;
- export and print — print, export to Markdown or HTML, send by email;
- display mode — switch between the visual editor and the raw markdown.
The slash menu
Section titled “The slash menu”A “/” at the start of a line opens the block menu, filtered as you type:
- basics — text, headings 1–3, quote, code block, divider, a KaTeX formula;
- lists — bulleted, numbered, checklist;
- media — an image by URL with alt text;
- diagrams — table, Excalidraw, Mermaid, PlantUML, mind map, markmap import, BPMN;
- notion-style blocks — task list, callouts (note, tip, warning, info), a collapsible block, columns;
- embeds — an embed by URL, a video for instance;
- AI commands — summarise, expand, rewrite, translate, continue.
Excalidraw is stored as a separate file next to the note and moves, deletes and restores with it. Mermaid, PlantUML, mind maps and BPMN live inside the note’s text as ordinary blocks — no separate files for them.
Markdown as you type
Section titled “Markdown as you type”Markup turns into formatting while you write: # for a heading, - for a
list, 1. for a numbered one, > for a quote, --- for a rule, triple
backticks for a code block. Inline works the same: **bold**, *italic*,
~~strikethrough~~, `code`, ==highlight==.
Wiki links and tags
Section titled “Wiki links and tags”[[Note title]] connects notes to each other; typing [[ brings up
autocomplete over titles. Tags go inline as #tag or into the right panel.
The right panel
Section titled “The right panel”An accordion of “Outline” and “History” — only one is ever open — plus the permanent “Tags” and “Information”.
Outline — the note’s headings, indented by level; clicking one scrolls the text to that place.
History — snapshots of the note. They are taken automatically on significant edits or roughly every 5 minutes, and manually with the “Snapshot” button. At most 10 are kept: a new one pushes out the oldest.
Clicking a version replaces the middle column with a comparison: the snapshot on the left, the current content on the right, differences highlighted. The Restore button replaces the current text with the version — but saves the current state as a snapshot first, so the undo is never lost. There is no “copy instead of replace” option.
Tags — chips with a cross (they delete instantly), a “+” for manual entry, and an AI generation button: generated tags are added to the existing ones rather than replacing them. A duplicate, case aside, is not added twice.
Information — read-only: created, updated, word count, and “Source” when the note came from converting a document.
Keyboard shortcuts
Section titled “Keyboard shortcuts”| Shortcut | Action |
|---|---|
| ⌘\ / Ctrl+\ | collapse the left panel |
| ⌘⇧\ / Ctrl+Shift+\ | collapse the right panel |
| ⌘B / Ctrl+B | bold |
| ⌘I / Ctrl+I | italic |
| ⌘Z / Ctrl+Z | undo |
| ⌘⇧Z / Ctrl+Shift+Z | redo |
| ⌘K / Ctrl+K | insert or edit a link |