Documentation

Everything here also ships inside the editor: :help <topic> opens the same text, rendered through the same markdown path, with no filesystem dependency — the bodies are embedded in the binary at build time. The website exists to give that corpus a reading order.

Two tiers. Guides teach a capability end-to-end and are worth reading straight through. Reference is one page per surface — a buffer kind, a minor mode, a language grammar — that you reach for by search or cross-link when you need a specific keystroke.

New here? Read these four, in order

  1. First steps First steps: the modal loop, opening and saving files, the command line, splits, and where to go next.
  2. Modal editing Modal editing: Normal / Insert / Visual / Select / Command / Search / Replace, the vim grammar (operators + motions + text objects + counts), and registers / marks / macros.
  3. Modes Major + minor modes: what they are, how :<mode-name> toggles work, major-mode swaps, auto-activation hooks, the option-resolution model.
  4. Buffers & panes Buffers, panes, splits, file tree, navigation, theme customization.

Prefer to learn by doing? The interactive tutor teaches the same ground from inside the editor.

Browse by area

Getting started

Your first hour: the modal loop, the interactive tutor, and how to look anything up.

8 topics · First steps, Interactive tutor, The launch dashboard, …

Editing

The vim grammar, the mode system, and the `:` line — the vocabulary everything else composes from.

9 topics · Modal editing, Yank ring, Cancelling a running operation, …

Navigating your project

Buffers, panes and splits, the fuzzy picker, filesystem views, and project-wide search.

34 topics · Buffers & panes, Picker & marginalia, File tree, …

Code intelligence

Language support, language servers, completion, folding, and the build/error loop.

8 topics · Languages, Language Server Protocol (LSP), The lsp-mode gate, …

Git & diffs

Magit — a full git porcelain inside the editor — plus general two- and three-way diffing.

5 topics · Magit, The status buffer, Transient menus, …

Language models

Call a model directly from the editor: chat in a buffer, ask about any text with a vim operator, review every edit, and control exactly what is sent.

9 topics · Language models, llm, llm-chat-mode, …

Terminal & AI agents

Shells as buffers, one-off shell commands, coding agents wired to the editor, and background-work notifications.

5 topics · Terminal buffers, Shell commands, Claude Code, …

Appearance

Soft-wrap and layout, the 21 builtin themes, and the per-pane status row.

4 topics · Display & layout, Themes & colorschemes, Modeline, …

Configuration & extension

Typed options, the Rust/WASM `init.rs`, and the plugin host.

7 topics · Options, init.rs, The <C-x> leader, …

Reference

Per-surface keymap tables: one buffer kind, one minor mode, or one language grammar each. Reach for search.

97 topics