Keyboard and accessibility
Every keyboard shortcut of the core and the ready UI, the Markdown shortcuts, and what the editor does for focus, roles, screen readers and reduced motion.
Shortcuts come from two places: extensions bind keys in the core, and the UI components handle keys inside their menus. Mod is ⌘ on macOS and Ctrl elsewhere; Alt is ⌥ Option on a Mac. Letter and digit shortcuts follow the physical key, so they also work on non-Latin layouts such as Russian. In a read-only editor, navigation and copying work and editing shortcuts are ignored. Menus and tooltips show only keys that are bound.
Formatting
| Shortcut | Action | Extension |
|---|---|---|
| Mod+B | Bold | Bold |
| Mod+I | Italic | Italic |
| Mod+U | Underline | Underline |
| Mod+Shift+X | Strikethrough | Strikethrough |
| Mod+E | Inline code | InlineCode |
| Mod+Shift+H | Highlight | Highlight |
| Mod+. | Superscript | Superscript |
| Mod+, | Subscript | Subscript |
| Mod+K | Link: opens the link field over selected text (the openLinkDialog event); see the note below |
Link |
Blocks and history
| Shortcut | Action | Extension |
|---|---|---|
| Mod+Alt+1 … Mod+Alt+6 | Heading 1–6, for the levels Heading offers (1–3 in DefaultPreset) |
Heading |
| Mod+Shift+7 | Numbered list, on or off | OrderedList |
| Mod+Shift+8 | Bullet list, on or off | BulletList |
| Mod+Shift+9 | To-do list, on or off | TodoList |
| Mod+Shift+B | Quote | Blockquote |
| Mod+Z | Undo | History |
| Mod+Shift+Z, Mod+Y | Redo | History |
Lists, tables and code
| Where | Shortcut | Action |
|---|---|---|
| List | Tab / Shift+Tab | Indent / outdent the item (bound by BulletList for every list) |
| Table | Tab / Shift+Tab | Next / previous cell of the same table, row by row, with its text selected |
| Code block | Tab | Insert two spaces |
| Code block | Shift+Tab | Remove up to two spaces at the start of the line |
| Code block | Escape | Add a paragraph after a top-level code block and move there |
| Formula | Escape | Add a paragraph after a top-level formula and move there (Math) |
Elsewhere Tab is not captured and moves focus to the next control, usually out of the editor. Tab in the last cell of a table and Shift+Tab in its first are not captured either: they never move the caret into another table. In the editor UI, Tab from the last cell reaches the table's Add row button.
Editing keys
| Key | Action |
|---|---|
| Enter | Split the block. A heading, quote or callout continues as a paragraph; a list item continues as an item. |
| Enter on an empty list item | Leave the list, or go one level up in a nested list. |
| Enter in a table cell | Move to the cell below. |
| Enter in a code block, a formula or another raw-text block | New line, as Shift+Enter. |
| Shift+Enter | Line break inside the same block. |
| Backspace at the start of a list item with text | Turn the item into a paragraph. |
Copy, cut and paste use the system keys; see content formats.
Markdown shortcuts
Type these in an empty paragraph:
| Type | Result | Extension |
|---|---|---|
# to ######, then a space |
Heading 1–6, for the levels Heading offers |
Heading |
- or *, then a space |
Bullet list | BulletList |
1. or any number and a dot, then a space |
Numbered list starting at that number | OrderedList |
[], then a space |
To-do list | TodoList |
[x], then a space |
To-do list with the item checked | TodoList |
>, then a space |
Quote | Blockquote |
```, an optional language, then a space |
Code block | CodeBlock |
--- |
Divider | Divider |
$$ |
Empty math block | Math |
/ |
Slash menu; also after a space inside a line | UI |
In an empty list item, a list shortcut of another kind turns the whole list into its kind; one of the list's own kind is only removed; [x] checks a task and [] unchecks it.
A shortcut changes the block and removes what you typed in one step: one Undo brings the typed text back. Where its block can't go — a table cell, or a column, toggle or quote that doesn't take that block — a shortcut stays the text you typed, and nothing is reported.
Anywhere in a line, **text**, *text*, ~~text~~ and `text` become bold, italic, struck-through and code text as you type the closing delimiter; see marks.
Editor UI
| Where | Keys | Action |
|---|---|---|
| Slash menu | ↑ ↓, Home, End | Move through the commands |
| Slash menu | Enter | Run the command |
| Slash menu | Escape; a space; deleting / |
Close; the caret stays in place |
| Bubble: Block type, More | ↓ | Open the popup |
| Bubble popups | ← → ↑ ↓, Home, End | Move between the buttons |
| Link field | Enter | Apply the link |
| Bubble popups | Escape | Close; the link editor returns the caret to the selection, the others return focus to their button |
| Block menu | ↑ ↓ | Move through the items |
| Block menu | → on Turn into, ← | Open the submenu, go back |
| Block menu | Escape | Close the submenu, then the menu; focus returns to the grip |
Heading anchor (docs view) |
— | Not a Tab stop and not part of the heading's name; copy a heading's link with the block menu's Copy link to block |
| Table column and row menus | ↑ ↓; Escape | Move; close and return focus to the handle |
| Column resize handle | ← → | Narrow or widen the column by 16 px |
| Image side handle | ← → | Narrow or widen the image by 16 px |
| Resize or touch drag in progress | Escape | Cancel |
| Image dialogs and More options | Escape | Close |
| Anywhere in the editor | Mod+J | Open or close the AI command bar (show); only in an editor whose AI extensions answer the bar |
| AI command bar | Enter; Escape | Send the prompt; close and cancel a running request |
| AI ghost text | Tab; Escape | Accept; dismiss |
| Theme toggle | ← → ↑ ↓, Home, End | Choose light, dark or system; one Tab stop |
| Page head title | Enter | Calls onTitleEnter instead of adding a line |
| Review card | Escape; Enter in the reply field | Close the card; send the reply |
| Callout icon field | Enter; Escape | Save; cancel |
Accessibility
Roles and names. The document is role="textbox" with aria-multiline, a name (ariaLabel; by default a11y.editorLabel of the interface language — "Document content" in English — and page.ariaLabel, "Page", in PageEditor) and aria-readonly when read-only. The slash menu is a dialog holding a listbox of options in labelled groups, with aria-activedescendant on the active one. The bubble is a toolbar: mark buttons carry aria-pressed and aria-keyshortcuts, Link and Colour open dialogs, More opens a menu, Block type a listbox. The fixed toolbar is one toolbar and one Tab stop: ← and → move between its tools, Home and End go to the ends, ↓ opens a list or More, Escape closes it; a tool that can't act is aria-disabled and described by the reason. The block handle is a toolbar with named buttons, and its menu uses menu and menuitem. Table handles have aria-haspopup="menu" and column types are menuitemradio. The theme toggle is a radiogroup, the docs outline a nav with aria-current, the loading skeleton a status with aria-busy. Task boxes are native checkboxes that Space toggles. Tooltips are hidden from assistive technology; each button keeps its own name.
Focus. Controls draw a ring in --gt-focus on :focus-visible; the document shows the caret instead of an outline. Closing a menu returns focus to where it came from, as in the table above. Image dialogs are modal <dialog> elements and give focus back when they close. The image toolbar is inert while hidden, so Tab skips it.
Screen readers. The slash menu announces the number of results in a polite live region, and AI progress is a polite status. A failed action puts a visually hidden alert in its control; the visible toast is hidden from assistive technology so the message is read once. Formatting changes, block moves and collaborators are not announced.
Reduced motion. With prefers-reduced-motion: reduce, animations and transitions of every GoTipe element (a gotipe-* class) and of what it holds shrink to 0.01 ms and run once: the document, the AI command bar, its status and spinner, the drop indicator, ghost text, menus and toasts, portals included. A spinner stands still instead of turning. Review cards and lane avatars stop animating, the docs outline jumps instead of scrolling smoothly, and review text appears at once. The rule is in @gotipe/theme/base.css.
Limitations
- Mod+K opens the link field of the bubble, or of
FixedToolbarwithout a bubble, only over selected text: with a caret alone it does nothing. - The block handle and block menu have no keyboard path. Change block types with the shortcuts, the slash menu or the bubble's Block type.
- No shortcut moves focus into the formatting bubble.
- Review cards open from the pointer or from
ref.current.review.focus(id); no key steps through suggestions. - Release testing covered roles, names, focus and keyboard paths in three browsers, not a screen reader; see browser support.