Appearance
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
| Key | Does |
|---|---|
| Mod+B | Bold |
| Mod+I | Italic |
| Mod+E | Code |
| Mod+Shift+X | Strikethrough |
| Mod+K | Link the selected words, or change the link the caret is in. With nothing to link, the app's search |
| Mod+Alt+1 … 3 | Heading 1–3 |
| Mod+Alt+0 | Back to a plain paragraph |
| Mod+Z | Undo |
| Mod+Shift+Z or Mod+Y | Redo |
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
| Key | Does |
|---|---|
| Enter | Split the line. An empty list item, or the empty last line of a quote, steps out instead |
| Shift+Enter | A line break within the block — in code, leave the block |
| Tab | Indent the item or code line, or move to the next table cell |
| Shift+Tab | Outdent — out of the list at the top level — or the previous cell |
| Backspace | At the start of a line: outdent an item, turn a heading back into text, then join |
| Esc | Leave the editor, so Tab moves on to the rest of the page |
| Mod+Enter | Tick 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+F | Find 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:
| Type | Get |
|---|---|
# … ###### | Heading, levels 1–6 |
- or * | Bulleted list item |
1. | Numbered list item |
[ ] / [x] | To-do item |
> | Quote |
```lang | Code 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
| Type | Opens |
|---|---|
/ | 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+R | Copy 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
| Key | Does |
|---|---|
| Mod+K | Find a page or run a command |
| Mod+Shift+F | Search the workspace: every match, by the page it is on |
| Mod+Shift+E | Reading mode on or off |
| ? | The keyboard shortcuts |
In the page tree
| Key | Does |
|---|---|
| Alt+↑ / ↓ | Move the focused page up or down among its siblings |
| Drag | Move a page: onto a row to put it inside, above or below to put it beside |
| Arrow keys on the tree's edge | Make the tree wider or narrower; Home and End for its narrowest and widest |