Appearance
The block editor
Type Markdown and it becomes blocks. Press / and pick a block from a menu. Both routes end in the same place, because the catalogue is data rather than UI — the slash menu, the input rules and the keyboard all drive one set of commands.
This page is about the rich editor, which is how a page is written unless somebody chooses otherwise. A page can instead be written as Markdown, as text.
The complete key and input-rule table is in keyboard and input rules, and ? shows the same list whenever you are not typing. The complete list of block types and what each exports as is in block types.
Markdown input rules
Typed at the start of a block, each of these converts it. Mid-sentence they are left alone — - in the middle of a line is a hyphen, and treating it as a list would be a trap.
| Type | Get |
|---|---|
# … ###### | Heading, levels 1–6 |
- or * | Bulleted list item |
1. | Numbered list item |
[ ] / [x] | To-do item, unchecked or checked |
> | Quote |
```lang | Code block, in that language |
--- or *** | Divider |
Inline, as you type: **bold**, *italic*, ~~strikethrough~~, `code` and [words](address) for a link. Code cannot also be bold, italic or struck — CommonMark cannot write that reliably, and silently corrupting it on export is not a trade worth making — but code can be a link.
The slash menu
/ opens the catalogue, filtered as you type. It matches both the title and a set of keywords, so /ul finds Bulleted list and /hr finds Divider.
- Basic — Text, Heading 1–3, Link
- Lists — Bulleted, Numbered, To-do
- Blocks — Quote, Callout, Code, Maths, Diagram, Divider, Table, Image
Plus Database view, which inserts a saved query over pages. Block references are inserted with (( — see block references — and people with @.
Words: bold, links and the selection bar
Select some words and a bar appears over them: bold, italic, struck, code and Link. Ctrl K links the selection too (with nothing selected, it is the app's search).
- Click inside a link to see where it goes, with Open (in a new tab, so nothing being written is lost), Change and Remove. Ctrl- or Cmd-click opens it at once; on a page you cannot edit, any click does.
- Addresses are tidied as typed:
example.combecomeshttps://example.com, an email address becomesmailto:. - Only web, mail, phone and Notesflow's own links are accepted. A
javascript:link pasted in from elsewhere is drawn with nowhere to go.
Links to other pages are made with [[ — see links and backlinks.
Naming people
Type @ and choose somebody in the workspace. They are told in their inbox, even if they were not watching the page. A mention is an ordinary link, so it exports as the words that were typed.
Code, maths and diagrams
A code block shows its language in its corner, where it can be changed, with the highlighter's languages suggested. Highlighting is worked out from the text each time and never stored, so the block holds exactly what was typed. Copy beside the language copies exactly the code — on a page you can only read, too.
Anything written after the language on the opening fence is kept exactly as written, so documentation written for Docusaurus, MkDocs or a similar site comes in and goes out unchanged: ```ts title="src/client.ts" {3-5}. A title is shown above the code, here and on a published site; the rest is kept for the tool that reads it. To change it, edit the fence in the Markdown. A ```diff block tints its added and removed lines.
Maths is a ```math fence: TeX, drawn beneath the source rather than in place of it. Diagrams are a ```mermaid fence, drawn beneath the source the same way. Both are ordinary code blocks, so they export as the fence they are and any other tool reads the text. Inline $…$ maths is not supported, because it is not part of GFM.
Diagrams are drawn in Mermaid's strict mode with no click handlers.
Images
/image uploads one from the device or takes its address on the web; dropping or pasting a file works too. Select an image to give it a description — its alt text in the Markdown, for whoever cannot see it. See attachments.
The block menu
Every block has a menu, from its grip in the margin or Ctrl /:
- Turn into another type of block. A code block turned into something else keeps its code.
- Move up, Move down, Indent, Outdent — children and all.
- Duplicate. The copy is a new block with its own identity, but keeps the day the original was placed on.
- Copy reference and Make referenceable — see block references.
- Comment, and Delete.
- Place on a day, pin or hide it in the timeline.
Structure
- Enter splits a block, and the new half gets an identity of its own. In a list it makes a sibling item; in an empty list item, or on the empty last line of a quote, it steps out.
- Shift+Enter is a line break inside the block; in a code block it leaves the block, so a page that ends in code never traps the caret.
- Tab / Shift+Tab indent and outdent a list item. Inside a table they walk the cells instead, and in code they indent the line.
- Alt+↑ / ↓ move a block among its siblings, children and all.
- Drag handles move top-level blocks. A drag goes through ProseMirror's own drag-and-drop, so it arrives as a
moveop and the block keeps its history. - Esc leaves the editor, so Tab moves on to the rest of the window.
Find and replace
Ctrl F with the caret in the page opens find: every match highlighted, Enter and Shift+Enter to move between them, match case, Replace and Replace all. A match stays within one block, a replacement keeps the formatting of what it replaced, and Replace all is one change and one undo. Outside the editor, Ctrl F is the browser's as ever; to search the whole workspace, see search.
Folding
Fold a heading's section, or a list item's nested items, from the toggle at the end of its line or with Ctrl .. Folding is a way of looking, not a change: nothing in the page, the log or the Markdown moves, and the folds are remembered per page on this device. Anything that puts the caret in folded text — find, a search result, a link to a block — opens the fold.
The clipboard
Markdown goes in and out of the clipboard in both directions, through the same serialiser that export uses. Paste a Markdown document and you get blocks; copy blocks and paste into any text editor and you get Markdown. Pasted blocks are new blocks with identities of their own.
That is not a convenience feature bolted on the side — it is the same projection, and it is enforced in CI that there is only one of them.
Tables
/table inserts a 3×3. Tables are editable in place, and export as GFM (fidelity T2). Tab walks the cells and adds a row past the last one; Mod+Enter adds a row too.
Callouts
/callout makes a note-style callout. It exports as an Obsidian-style > [!NOTE] blockquote, so any Markdown viewer shows the text; the variant travels in a sidecar comment. That makes it T3 — readable everywhere, exact here.
What is undo, exactly
Under collaboration, undo is yours. It is Yjs's undo rather than the editor's own history, because a local history stack would happily undo somebody else's edit — from its point of view, a remote change is just another transaction that arrived.