Keyboard shortcuts
Every keyboard shortcut in the editor, on macOS and on Windows or Linux, from bold and headings through find, links and block selection.
Mod is Cmd on macOS and Ctrl elsewhere. The editor reads every shortcut from one registry, so the hints in its menus and the handlers in the editor cannot drift apart.
Shortcuts
| Action | macOS | Windows and Linux |
|---|---|---|
| Paragraph | ⌘+⌥+0 | Ctrl+Alt+0 |
| Paragraph (second binding) | ⌘+⇧+0 | Ctrl+Shift+0 |
| Heading 1 | ⌘+⌥+1 | Ctrl+Alt+1 |
| Heading 2 | ⌘+⌥+2 | Ctrl+Alt+2 |
| Heading 3 | ⌘+⌥+3 | Ctrl+Alt+3 |
| Code block: exit | ⌘+Enter | Ctrl+Enter |
| Footnote definition: jump to its first reference | ⌘+Enter | Ctrl+Enter |
| To-do: check it | ⌘+Enter | Ctrl+Enter |
| Link: open the link popover | ⌘+K | Ctrl+K |
| Inline equation: insert or wrap | ⌘+⇧+E | Ctrl+Shift+E |
| Inline date: insert today | ⌘+; | Ctrl+; |
| Bold | ⌘+B | Ctrl+B |
| Italic | ⌘+I | Ctrl+I |
| Underline | ⌘+U | Ctrl+U |
| Strikethrough | ⌘+⇧+X | Ctrl+Shift+X |
| Inline code | ⌘+E | Ctrl+E |
| Superscript | ⌘+. | Ctrl+. |
| Subscript | ⌘+, | Ctrl+, |
| Indent | ⌘+] | Ctrl+] |
| Outdent | ⌘+[ | Ctrl+[ |
| Indent in a list | Tab | Tab |
| Bulleted list | ⌘+⇧+8 | Ctrl+Shift+8 |
| Numbered list | ⌘+⇧+7 | Ctrl+Shift+7 |
| To-do list | ⌘+⇧+9 | Ctrl+Shift+9 |
| Find and replace: open | ⌘+F | Ctrl+F |
| Block menu: open | ⌘+/ | Ctrl+/ |
| Block selection: select the block text, then all blocks | ⌘+A | Ctrl+A |
| Block selection: duplicate | ⌘+D | Ctrl+D |
| Block selection: move up | ⌘+⇧+⌥+ArrowUp | Ctrl+Shift+Alt+ArrowUp |
| Block selection: move down | ⌘+⇧+⌥+ArrowDown | Ctrl+Shift+Alt+ArrowDown |
| Undo | ⌘+Z | Ctrl+Z |
| Redo | ⌘+⇧+Z | Ctrl+Shift+Z |
| Clear formatting | ⌘+\ | Ctrl+\ |
Where the hints are shown
The slash menu, the Turn into menus, the block menu, the selection toolbar, the find bar and the block handle show the keys of their commands. macOS and iOS show glyphs (⌘ ⌥ ⇧), and other platforms show names (Ctrl, Alt, Shift). A touch-only device shows no hints at all.
The
shortcutHints option turns the hints off for the whole editor, together with the aria-keyshortcuts attributes. The shortcuts themselves keep working. See Options.Keys the editor takes over
Mod+Fopens the editor's find bar when focus is in the editor, in place of the browser's find.Tabindents a list item instead of moving focus. Outside a list it moves focus as usual.- A markdown shortcut typed through an input method composition does not convert, for example
-then space on a Vietnamese IME.
Input rules
Some formatting has no shortcut and is typed instead. These convert as you type, and every one of them is a block or mark that a feature switch can turn off.
#,##,###then space: heading 1, 2 and 3.>then space: quote.---: divider.-,1.or[]then space: bulleted, numbered or to-do list. A number above 1 restarts the numbering.```then space: code block.- Around text:
**bold,*or_italic,~~strikethrough, a backtick inline code. - A URL then space or Enter becomes a link.
:then a name opens emoji suggestions.