Skip to content

The note editor

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.

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.

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.

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==.

[[Note title]] connects notes to each other; typing [[ brings up autocomplete over titles. Tags go inline as #tag or into 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.

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