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