Vim Cheatsheet
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
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.txtWatch 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 commandsType & 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 textDelete, 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 objectsSelect 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 modeSearch & replace
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 searchFiles, 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 pagesMacros & registers
Registers are named clipboards: yanks and deletes go into them, and macros are keystrokes recorded into them.
Official docs: RegistersSettings & 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 vimrcTry 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.