Keyboard shortcuts and the command palette
This page is for anyone who writes in the editor with a keyboard. It shows how to find any command, line, rule or instruction with the command palette, and lists every shortcut the editor has.
Open the command palette
Press Ctrl+K (on a Mac, ⌘K). A search box opens over the editor. Type a few letters of what you want to do, such as "publish" or "line numbers", and press Enter on the row you want. Each row shows its shortcut, when it has one, so you learn the keys as you go.
The box can also take you somewhere directly. Start what you type with one of these characters:
| Type | What you get |
|---|---|
| : and a number | Go to line: :12 and Enter takes you to line 12 of the text. |
| @ and a few words | Every section and block, such as a rule, a guardrail, an example or a figure, with its line. Pick one to go there. |
| ? and a few words | The keyboard shortcuts. Pick one to run it. |
If the assistant is on, anything longer than three characters also gives a last row, ✦ Ask the assistant: “…”. It asks the assistant about what you selected, or about the whole instruction. See The assistant.
On a phone or a tablet there is no shortcut. Use Search in the side bar, or the Search button in the header, instead. It opens the same box as a sheet, and lists the instructions whose names match under the commands.
Go to an instruction by name or by meaning
Press Ctrl+P (on a Mac, ⌘P) to open Go to an instruction by name. Type part of a name to see the instructions that match, with their folder. A row can carry small marks:
- ★: one of your favorites.
- v3 (or another number): the version agents follow now.
- open: the instruction you have open.
Use ↑ and ↓ to choose, Enter to open it and Esc to close the box.
When you are signed in, the box also searches by meaning. Type a few words, such as "refunds over the limit", and wait a moment. Instructions that are about that, even with other words, appear after the name matches, marked by meaning. Each shows a short passage from the instruction instead of its folder.
The box lists up to 200 instructions. When there are more, its last line says how many, and you can type more to narrow the list.
The keyboard shortcuts list
The editor has its own list of every shortcut. Open it in any of these ways:
- Press Ctrl+/ or ? (on a Mac, ⌘/ or ?). The ? key works only when you aren't typing in the text or in a box.
- Click the Keyboard shortcuts button in the status bar, at the bottom right.
- Type ? in the command palette.
Search the list by what a key does ("comment") or by the key itself. "ctrl k", "cmd+k" and "⌘K" all find the same row. Press Enter on a command's row, or click it, to run that command. The list shows the keys for your computer. Use Show Mac keys or Show Windows and Linux keys at its foot to see the other.
The writing keys
The keys that insert a rule or a block use two modifier keys and a letter: Alt+Shift on Windows and Linux, and ⌃ (Control) with ⇧ (Shift) on a Mac. On a Mac, the Option key types letters, so the editor doesn't use it here.
These keys go by where the key sits on the keyboard, not by the letter it types. On a keyboard that isn't English, the key is the one where M, S or N sits on an English keyboard. When the list can't tell which letter your keyboard prints there, it adds (key position).
Every shortcut
The tables below are read from the editor itself, in the groups and order its own list uses. "Where" says where the key works, when it doesn't work everywhere. A Mac uses ⌘ where Windows and Linux use Ctrl, apart from the few keys that use ⌃ (Control) on a Mac too.
General
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Command palette | Ctrl+K | ⌘K | |
| Keyboard shortcuts | Ctrl+/ or ? | ⌘/ or ? | |
| Close menus | Esc | Esc | |
| To Content · Preview — Escape there goes back to the text | Alt+F10 | ⌥F10 |
File
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Keep a checkpoint now | Ctrl+S | ⌘S | |
| Download .md | Ctrl+Shift+S | ⇧⌘S |
Edit
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Comment on the selection | Alt+Shift+C | ⌃⇧C | In the text · key position |
| Turn into, format… | Shift+F10 | ⇧F10 | In the text |
| Move section up | Alt+Shift+↑ | ⌥⌘↑ | In the text |
| Move section down | Alt+Shift+↓ | ⌥⌘↓ | In the text |
Go
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Go to line… | Ctrl+G | ⌃G | |
| Go to a rule or section… | Ctrl+Shift+. or Ctrl+> | ⇧⌘. or ⌘> | |
| Go to an instruction… | Ctrl+P | ⌘P | |
| In the command palette: the keyboard shortcuts | ? | ? | |
| In the command palette: go to a line | : | : | |
| In the command palette: go to a rule or section | @ | @ |
View
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Show or hide the side bar | Ctrl+B | ⌘B | |
| Instructions | Ctrl+Shift+E | ⇧⌘E | |
| Changes | Ctrl+Shift+G | ⇧⌘G | |
| History | Ctrl+Shift+H | ⇧⌘H | |
| Contents | Ctrl+Shift+O | ⇧⌘O | |
| Assistant | Ctrl+Shift+Space | ⇧⌘Space | |
| Preview beside the text | Ctrl+\ | ⌘\ | |
| Move the divider between the text and the preview | ← or → | ← or → | On the divider |
Versions
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Publish… | Ctrl+Enter | ⌘↵ |
Changes
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Publish from the message box | Ctrl+Enter | ⌘↵ | Changes |
History
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Previous version | ↑ | ↑ | History |
| Next version | ↓ | ↓ | History |
| Show a version's actions | Enter | ↵ | History |
| Pick two versions to compare | Ctrl+click | ⌘ click | History |
Writing
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Insert MUST: | Alt+Shift+M | ⌃⇧M | In the text · key position |
| Insert SHOULD: | Alt+Shift+S | ⌃⇧S | In the text · key position |
| Insert NEVER: | Alt+Shift+N | ⌃⇧N | In the text · key position |
| Insert a guardrail | Alt+Shift+G | ⌃⇧G | In the text · key position |
| Insert an example | Alt+Shift+E | ⌃⇧E | In the text · key position |
| Insert a new section | Alt+Shift+H | ⌃⇧H | In the text · key position |
| At the start of a line: add a rule, a block, a figure | / | / | In the text |
| Pick in the / list and the suggestions | ↑ or ↓ | ↑ or ↓ | |
| Insert what is picked | Enter or Tab | ↵ or ⇥ | |
| Close the list | Esc | Esc |
Problems
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Quick fix — the problems on the caret's line | Ctrl+. | ⌘. | In the text |
| Next problem | F8 | F8 | |
| Previous problem | Shift+F8 | ⇧F8 |
Editing keys
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Indent — the selected lines, or two spaces | Tab | ⇥ | In the text |
| Outdent the selected lines (without a selection: leave the text) | Shift+Tab | ⇧⇥ | In the text |
| Continue a list; on an empty item, end it | Enter | ↵ | In the text |
| A page up or down (with Shift, selecting) | PageUp or PageDown | PageUp or PageDown | In the text |
| Undo — fixes too | Ctrl+Z | ⌘Z | |
| Redo | Ctrl+Shift+Z or Ctrl+Y | ⇧⌘Z |
Drawing
| What it does | Windows and Linux | Mac | Where |
|---|---|---|---|
| Pen, arrow, box, ellipse, text, eraser | P or A or R or O or T or E | P or A or R or O or T or E | |
| Undo a stroke | Ctrl+Z | ⌘Z | |
| Redo a stroke | Ctrl+Shift+Z or Ctrl+Y | ⇧⌘Z | |
| Insert the drawing | Ctrl+Enter | ⌘↵ |
A few rows depend on what is on:
- Assistant opens the assistant only where the assistant is on for your organization. See The assistant.
- Publish… works only when you may publish the instruction. See Publish, schedule and write a version message.
- The Changes and History rows work while that panel is open.
- The Drawing keys work while the drawing pad is open. See Add diagrams, drawings and media.
A key that can't do anything at the moment, such as a writing key in a read-only instruction, is left to the browser. The exceptions are Ctrl+S (on a Mac, ⌘S) and Ctrl+Shift+S (on a Mac, ⇧⌘S): they never open the browser's "Save page", even when they can't run.
If a shortcut doesn't work
| What you see | Why | What to do |
|---|---|---|
| The browser does something else, such as open a bookmark | The command can't run now, for example because the instruction is read-only, or the shortcut belongs to a panel that isn't open. | Open the panel, or check the header: Read-only or Preview means nothing can be changed here. |
| Nothing happens while you type in Japanese, Chinese or another language with an input method | While a character is being composed, no shortcut runs. | Finish the character first, then press the shortcut. |
| A writing key does nothing | Writing keys work only in the text, not in a box or a panel. | Click in the text first, or type / at the start of a line, or use the + between sections. |
| The command palette shows no keys on a tablet | The editor treats a touch screen as having no keyboard. The keys still work with a keyboard attached. | Use the Search button in the header, or the keys from the tables above. |
| Still stuck | Ask us at Support. |