Skip to content

Keyboard and input rules ​

Mod is Cmd on macOS and Ctrl elsewhere. Press ? in the app, when you are not typing, for the same list; it is generated from the table that sits directly above the key bindings in the code, so the two cannot drift.

Writing ​

KeyDoes
Mod+BBold
Mod+IItalic
Mod+ECode
Mod+Shift+XStrikethrough
Mod+KLink the selected words, or change the link the caret is in. With nothing to link, the app's search
Mod+Alt+1 … 3Heading 1–3
Mod+Alt+0Back to a plain paragraph
Mod+ZUndo
Mod+Shift+Z or Mod+YRedo

Code cannot also be bold, italic or struck — see why. It can be a link.

Under collaboration, undo is yours, not the document's — a local history stack would happily undo somebody else's edit, since from its point of view a remote change is just another transaction that arrived.

Structure ​

KeyDoes
EnterSplit the line. An empty list item, or the empty last line of a quote, steps out instead
Shift+EnterA line break within the block — in code, leave the block
TabIndent the item or code line, or move to the next table cell
Shift+TabOutdent — out of the list at the top level — or the previous cell
BackspaceAt the start of a line: outdent an item, turn a heading back into text, then join
EscLeave the editor, so Tab moves on to the rest of the page
Mod+EnterTick or untick a to-do; in a table, add a row
Alt+↑ / ↓Move the block up or down among its siblings, children and all
Mod+.Fold or unfold the section under this heading, or this item's nested items
Mod+/The menu for this block — turn into, move, duplicate, delete, its day in the timeline
Mod+FFind and replace in the page, while the caret is in it

Tab is never ambiguous: the caret is in a table, a list or code, not two of them.

Input rules ​

Typed at the start of a block:

TypeGet
# … ###### Heading, levels 1–6
- or * Bulleted list item
1. Numbered list item
[ ] / [x] To-do item
> Quote
```langCode block
--- or ***Divider

Mid-sentence they are left alone: - in the middle of a line is a hyphen.

Inline, anywhere: **bold**, *italic*, ~~strikethrough~~, `code`, and [words](address) for a link.

Inserting ​

TypeOpens
/The block catalogue
[[Page search, to link one — and to create the page you just named
((Block search, to reference one
@People in the workspace, to name one
Alt+Shift+RCopy a reference to this block, to paste on another page

A [[ query may contain spaces, because page titles do; it may not contain a bracket, so a closed [[…]] pasted from elsewhere does not reopen the menu behind the caret. An @ inside a word — [email protected] — is an address, not a mention.

Anywhere in the app ​

KeyDoes
Mod+KFind a page or run a command
Mod+Shift+FSearch the workspace: every match, by the page it is on
Mod+Shift+EReading mode on or off
?The keyboard shortcuts

In the page tree ​

KeyDoes
Alt+↑ / ↓Move the focused page up or down among its siblings
DragMove a page: onto a row to put it inside, above or below to put it beside
Arrow keys on the tree's edgeMake the tree wider or narrower; Home and End for its narrowest and widest

Blocks and the op log are canonical. Markdown is a projection. Git is a target.