Skip to main contentEric N. Garcia

vi

This is a vi cheatsheet sourced from source

Modes

Vi has two modes insertion mode and command mode. The editor begins in command mode, where the cursor movement and text deletion and pasting occur. Insertion mode begins upon entering an insertion or change command. [ESC] returns the editor to command mode (where you can quit, for example by typing :q!). Most commands execute as soon as you type them except for “colon” commands which execute when you press the return key.

Quitting

CommandDescription
:xExit, saving changes
:qExit as long as there have been no changes
ZZExit and save changes if any have been made
:q!Exit and ignore any changes

Inserting Text

CommandDescription
iInsert before cursor
IInsert before line
aAppend after cursor
AAppend after line
oOpen a new line after current line
OOpen a new line before current line
rReplace one character
RReplace many characters

Motion

CommandDescription
hMove left
jMove down
kMove up
lMove right
wMove to next word
WMove to next blank delimited word
bMove to the beginning of the word
BMove to the beginning of blank delimited word
eMove to the end of the word
EMove to the end of Blank delimited word
(Move a sentence back
)Move a sentence forward
{Move a paragraph back
}Move a paragraph forward
0Move to the beginning of the line
$Move to the end of the line
1GMove to the first line of the file
GMove to the last line of the file
nGMove to nth line of the file
:nMove to nth line of the file
fcMove forward to c
FcMove back to c
HMove to top of screen
MMove to middle of screen
LMove to bottom of screen
%Move to associated ( ), , [ ]

Deleting Text

Almost all deletion commands are performed by typing d followed by a motion. For example, dw deletes a word. A few other deletes are:

CommandDescription
xDelete character to the right of cursor
XDelete character to the left of cursor
DDelete to the end of the line
ddDelete current line
:dDelete current line

Yanking Text

Like deletion, almost all yank commands are performed by typing y followed by a motion. For example, y$ yanks to the end of the line. Two other yank commands are:

CommandDescription
yyYank the current line
:yYank the current line

Changing text

The change command is a deletion command that leaves the editor in insert mode. It is performed by typing c followed by a motion. For example cw changes a word. A few other change commands are:

CommandDescription
CChange to the end of the line
ccChange the whole line

Putting text

CommandDescription
pPut after the position or after the line
PPut before the position or before the line

Buffers

Named buffers may be specified before any deletion, change, yank or put command. The general prefix has the form “c where c is any lowercase character. for example, “adw deletes a word into buffer a. It may thereafter be put back into text with an appropriate “ap.

Markers

Named markers may be set on any line in a file. Any lower case letter may be a marker name. Markers may also be used as limits for ranges.

CommandDescription
mcSet marker c on this line
`cGo to beginning of marker c line.
'cGo to first non-blank character of marker c line.

Search for strings

CommandDescription
/stringSearch forward for string
?stringSearch back for string
nSearch for next instance of string
NSearch for previous instance of string

Replace

The search and replace function is accomplished with the :s command. It is commonly used in combination with ranges or the :g command (below).

CommandDescription
:s/pattern/string/flagsReplace pattern with string according to flags.
gFlag - Replace all occurrences of pattern
cFlag - Confirm replaces.
&Repeat last :s command

Regular Expressions

CommandDescription
. (dot)Any single character except newline
*zero or more occurrence of any character
[...]Any single character specified in the set
[^...]Any single character not specified in the set
^Anchor - beginning of the line
$Anchor - end of line
\<Anchor - beginning of word
\>Anchor - end of word
\(...\)Grouping - usually used to group conditions
\nContents of nth grouping

[…] - Set Examples

CommandDescription
[A-Z]The SET from Capital A to Capital Z
[a-z]The SET from lowercase a to lowercase z
[0-9]The SET from 0 to 9 (All numerals)
[./=+]The SET containing . (dot), / (slash), =, and +
[-A-F]The SET from Capital A to Capital F and the dash (dashes must be specified first)
[0-9 A-Z]The SET containing all capital letters and digits and a space
[A-Z][a-zA-Z]In the first position, the SET from Capital A to Capital Z In the second character position, the SET containing all letters

Regular Expression Examples

| Command | Description | | ------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | /Hello/ | Matches if the line contains the value Hello | | /^TEST$/ | Matches if the line contains TEST by itself | | /^[a-zA-Z]/ | Matches if the line starts with any letter | | /^[a-z].*/ | Matches if the first character of the line is a-z and there is at least one more of any character following it | | /2134$/ | Matches if line ends with 2134 | | /\(21 | 35\)/ | Matches is the line contains 21 or 35 Note the use of ( ) with the pipe symbol to specify the ‘or’ condition | | /[0-9]*/ | Matches if there are zero or more numbers in the line | | /^[^#]/ | Matches if the first character is not a # in the line |

Notes:

  1. Regular expressions are case sensitive
  2. Regular expressions are to be used where pattern is specified

Counts

Nearly every command may be preceded by a number that specifies how many times it is to be performed. For example, 5dw will delete 5 words and 3fe will move the cursor forward to the 3rd occurrence of the letter e. Even insertions may be repeated conveniently with this method, say to insert the same line 100 times.

Ranges

Ranges may precede most “colon” commands and cause them to be executed on a line or lines. For example :3,7d would delete lines 3-7. Ranges are commonly combined with the :s command to perform a replacement on several lines, as with :.,$s/pattern/string/g to make a replacement from the current line to the end of the file.

CommandDescription
:n,mRange - Lines n-m
:.Range - Current line
:$Range - Last line
:'cRange - Marker c
:%Range - All lines in file
:g/pattern/Range - All lines that contain pattern

Files

CommandDescription
:w fileWrite to file
:r fileRead file in after line
:nGo to next file
:pGo to previous file
:e fileEdit file
!!programReplace line with output from program

Other

CommandDescription
~Toggle upp and lower case
JJoin lines
.Repeat last text-changing command
uUndo last change
UUndo all changes to line