Shortcuts

Every keyboard shortcut outl ships with, across every client, in one table per concern.

Source of truth

The desktop and TUI both pull their chord catalog from crates/outl-shortcuts (src/defaults.rs::default_bindings()). The mobile app doesn’t expose a keyboard surface (touch + on-screen keyboard); the rows below leave its column blank when there’s nothing to bind.

One catalog, two adapters. The TUI converts crossterm::KeyEvent → Chord, the desktop converts browser KeyboardEvent → Chord. Both then call the same outl_shortcuts::lookup(mode, chord) → Action. A chord change in defaults.rs lights up on both clients on the next build.

If a row below disagrees with what you observe in the app, the code is right and this doc is stale — file an issue or fix the row.

How to read the tables

• Chrome / Global chords fire in every mode.
• Normal / Insert / Visual / Overlay mirror the vim modes. The desktop subscribes to Normal/Visual only while editor.vim_mode = true (see docs/config.md); chrome and Insert chords are always live.
• Cmd is the macOS modifier; Ctrl is the same chord on Linux / Windows / TUI. We list one form per row to keep the table readable.
• A chord in the form q q is a vim-style two-key sequence: press the first, then the second within ~1 s.

Chrome (Global) — works in any mode

Why Cmd+J and not Cmd+T for today’s journal? Every outliner ecosystem uses T for task / TODO — TUI’s Ctrl+T, Logseq’s Cmd+T, the universal Markdown checkbox shortcut. Re-training that muscle memory would be hostile. J for journal is unambiguous and lines up with the TUI’s g j chord.

Defaults the user often asks about. Both clients ship with sidebar and backlinks panel HIDDEN (show_sidebar: false, show_backlinks: false). Editor-hero on first launch — the user opts the panels in with the chord. This matches Bear / Ulysses on the desktop and outl-tui’s historical behaviour.

Why the shifted variants for sidebar / backlinks

So Cmd+Shift+E (VS Code’s “Show Explorer”) and Cmd+Shift+B are the canonical chrome chords on the desktop, and the TUI mirrors the spirit with Ctrl+E / Ctrl+B (most terminals collapse Ctrl+Shift+letter into Ctrl+letter, so both forms work identically).

Inline markdown — Insert mode (textarea focused)

Wrap the current selection (or insert the delimiter pair around the caret). Mirrors the convention every markdown editor on the planet ships.

outl ships _…_ as the canonical italic. The parser still accepts *…* for compatibility, but .md projections emit underscores.

Outline navigation — Normal mode

The desktop honours Normal/Visual only while editor.vim_mode = true. The TUI is vim-style by definition.

About a / * / # on the desktop. The desktop’s Normal mode has only a selected block id — no character cursor inside the block. So a collapses to i (the textarea’s own caret takes over), and * / # seed the picker with the first few words of the selected block’s text instead of doing a word-under-cursor search. The catalog still ships these chords so muscle memory from the TUI carries over.

Cmd+X / Cmd+C / Cmd+V are mode-aware on the desktop. Inside a block editor (Insert mode, a <textarea> is focused) they are the OS-native text cut / copy / paste — the chords aren’t in the catalog there, so the keystroke reaches the webview untouched. In view mode (Normal, nothing focused) they act on the whole selected block + its subtree: cut marks it to move by id (the paste emits a single Op::Move, so ((blk-…)) refs and backlinks survive — and the target may live on another page, moving the block across pages), copy snapshots it as markdown (the paste duplicates with fresh ids). This is also why run code block moved off Cmd+X to Cmd+Shift+X (view mode): a text-editing app has to let the OS-wide cut win.

Cmd/Ctrl+Shift+Enter works without vim mode. Unlike o, the chord is not vim-gated: with no textarea focused the desktop falls into Normal dispatch regardless of the vim_mode setting, so every user can append a block from view mode. Inside a block editor the same chord commits the current edit first (Insert-mode CommitAndContinue). Both Cmd+Shift+Enter (macOS) and Ctrl+Shift+Enter (Windows / Linux) are bound in each mode.

Cursor inside a block (Normal)

These rely on a character cursor inside the selected block. The TUI ships it natively; the desktop has only a selected block id, so the char-cursor ops surface a status-line nudge instead of firing.

Insert mode (text editing)

Visual mode (range)

TUI + desktop (vim on); mobile has no Visual equivalent yet.

Overlays (picker, palette, settings, help)

The picker (Cmd+P / Ctrl+P) fuzzy-matches pages and journals together; type a date in ISO (2026-06-04) or natural (today, yesterday) to jump.

Where each chord lives in the code

A chord change is a single line in defaults.rs plus, if the action is new, a row in action.rs and a handler in each client. See crates/outl-shortcuts/CLAUDE.md for the full add-a-binding checklist.

Help overlay vs. this doc

In the TUI, press ? (Normal mode) to see the live chord table baked into the binary — it’s generated from the same default_bindings() table this doc describes. In the desktop, Cmd+/ opens the same overlay. If you need to look something up while typing, the in-app overlay is faster than this page.

This doc exists so a contributor (or a user shopping for outl) can see every shortcut without launching the app.