Skip to content
Edit on GitHub

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.

@gotipe/core@gotipe/react@gotipe/block-editor

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 (showAiCommandBar); 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 FixedToolbar without 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.