Skip to main content
kitlocal.dev

Vim Cheatsheet

Runs locally

100% processed in your browser. Inputs and outputs never leave your device.

Vim commands in plain language: modes, motions, operators, search and replace, macros and settings, with examples run on Vim 9.1.

How it works

Vim is modal: the same key does different things depending on the mode. Normal mode (the default) runs commands, Insert mode types text, Visual mode selects text and Command-line mode (the colon prompt) runs Ex commands. Most edits read like a sentence: an operator (d, c, y) plus a motion or text object (w, ip, i").

Survival kit

The few commands to learn first.

80 commands

Keyboard shortcuts/Focus searchJKMove selectionCCopy selectedFBookmark selectedEscClear search

Open, save & quit

If you ever feel lost, press Esc a couple of times: it always returns you to Normal mode, where the commands below work.

Official docs: Starting Vim
  • Essential

    Open a file in Vim.

    vim <file>

    Build the command

    vim <file>

    Values are inserted exactly as typed. Quote them yourself if they contain spaces or special characters.

    When to use it

    Starts editing an existing file, or a new one that is created the first time you save.

    Breakdown

    vim
    the editor
    <file>
    path of the file to open (it need not exist yet)

    Example

    Opens notes.txt, or an empty buffer called notes.txt if the file does not exist.

    vim notes.txt

    Watch out

    • Stuck? Press Esc, type :q! and press Enter to leave without saving.

    See also

Move around

Learn motions first: every delete, change and yank command takes a motion, so moving well is the same skill as editing well.

Official docs: Motion commands

Type & fix text

Small edits you will do all day: start typing in the right place, remove or replace a character, undo, and repeat.

Official docs: Inserting and changing text

Delete, copy & change (operators)

Vim edits are sentences: operator + (count) + motion or text object. d = delete, c = change, y = yank (copy). Learn the verbs once and combine them with every noun.

Official docs: Operators and text objects

Select first, then act

Visual mode shows what you will affect before you press the operator. It is slower than a good motion but friendlier while you learn.

Official docs: Visual mode

Searching is just another motion, so d/foo deletes up to the next foo. Search and substitute both use regular expressions.

Official docs: Patterns and search

Files, buffers, windows & tabs

A buffer is a file in memory, a window is a view of a buffer, and a tab page is a set of windows. You can have many buffers open without showing them all.

Official docs: Windows, buffers and tab pages

Macros & registers

Registers are named clipboards: yanks and deletes go into them, and macros are keystrokes recorded into them.

Official docs: Registers

Settings & your vimrc

Options are changed with :set and last until you quit. Put the ones you like in your vimrc so they apply every time.

Official docs: Options and vimrc

Try it in a KitLocal tool

Glossary
Normal mode
The default mode, where keys are commands. Press Esc to return here.
Insert mode
The mode where typed characters become text.
Visual mode
Select text with v, V or Ctrl-v, then apply an operator to it.
Ex command
A command typed after a colon, such as :w or :%s/a/b/g.
Motion
A command that moves the cursor (w, $, gg). Operators act on the text it covers.
Operator
A command that acts on text: d (delete), c (change), y (yank = copy), > (indent).
Text object
A region such as a word, quoted string or paragraph, chosen with i (inner) or a (around).
Register
A named storage slot for yanked or deleted text, like a clipboard with many slots.
Buffer
A file loaded in memory. A window shows a buffer; a tab page holds windows.