vi

A self-compiled cheatsheet for usage of vi

Posted April 16, 2021 by Adrian Wyssmann

Introduction

Mode	Description
normal mode	This is the standard mode when you enter vim. Here you can move around but not modify text unless you issue a command lik insert or append
insert mode	In the insert mode you can modify the text. Importantly to notice is that you will see `-- INSERT --` on the last line. In this mode you can move with the arrow keys. To exit this mode, you have to press `[ESC]`
visual mode	In the visual mode you can navigate and manipulate text selections. It is similar to normal mode and you can perform the same commands.
ex-mode	This mode allows you to enter ex commands as you can do in the command line. Unless the command line, the ex-mode does not return automatically to the normal mode. Note that the Ex mode is designed for Batch processing and as such won’t support mappings or command-line editing. This mode is entered with `Q` and exited by entering `:visual`

command line

On the command line allows you to run ex commands enter search patterns, and enter filter commands. As soon as you start typing : or / you are on the command line and you can enter commands. After that vim automatically return to normal mode.

Terms

Many commands that change text are made from an operator and a motion so e.g. an example of deleting text with d

d motion

d is the delete operator
motion is what the operator will operate on e.g. w would delete text until the start of the next word, EXCLUDING its first character.

Also know that a word

punctuation considered words
spaces separates words

Editing a file

Command	Description
`:e[dit]`	Edit the current file. This is useful to re-edit the current file, when it has been changed outside of Vim.
`:e[dit]!`	Edit the current file always. Discard any changes to the current buffer. This is useful if you want to start all over again.
`:e[dit] {file}`	Edit {file}
`:e[dit]! {file}`	Edit {file} always. Discard any changes to the current buffer.
`gf`	Edit the file whose name is under or after the cursor. Mnemonic: “goto file”.

General

Keys	Description
`u`	undo
`Ctrl+r`	redo
`.`	repeat last command

Cursor movement (Inside command/normal mode)

Keys	Command	Description
`h`		move cursor left
`j`		move cursor down
`k`		move cursor up
`l`		move cursor right
`w`		jump by start of words
`W`		jump by words
`e`		jump to end of words
`E`		jump to end of words
`b`		jump backward by words
`B`		jump backward by words
`0` (zero)		start of line
`^`		first non-blank character of line (same as `0w`)
`$`		end of line
`Ctrl+d`		move down half a page
`Ctrl+u`		move up half a page
`}`		go forward by paragraph (the next blank line)
`{`		go backward by paragraph (the next blank line)
`gg`		go to the top of the page
`G`		go the bottom of the page
`[num] G`	:[num] [enter]	Go to that line in the document

Search and Replace

Keys	Command	Description
`f [char]`		Move to the next char on the current line after the cursor
`F [char]`		Move to the next char on the current line before the cursor
`t [char]`		Move to before the next char on the current line after the cursor
`T [char]`		Move to before the next char on the current line before the cursor
`;`		go to the next searched item
`,`		go to the previous searched item
	`/pattern`	search for pattern
	`?pattern`	search backward for pattern
`n`		repeat search in same direction
`N`		repeat search in opposite direction
	`:%s/old/new/g`	replace all old with new throughout file (gn is better though)
	`:%s/old/new/gc`	replace all old with new throughout file with confirmations

Insert/Appending/Editing Text

Any of these results in Insert mode. Press Esc or Ctrl+[ to exit insert mode

Keys/Command	Description
`i`	start insert mode at cursor
`I`	insert at the beginning of the line
`a`	append after the cursor
`A`	append at the end of the line
`o`	open (append) blank line below current line (no need to press return)
`O`	open blank line above current line
`cc`	change (replace) an entire line
`c [movement command]`	change (replace) from the cursor to the move-to point
`r [char]`	replace a single character with the specified char (does not use Insert mode)
`d`	delete
`d [movement command]`	deletes from the cursor to the move-to point
`dd`	delete the current line
`J`	join line below to the current one
`:r[ead] {name}`	Insert the file [name] below the cursor.
`:r[ead] !{cmd}`	Execute {cmd} and insert its standard output below the cursor.

Marking text (visual mode)

In visual mode you can move around as in normal mode (h, j, k, l etc.) and can then do a command (such as y, d, or c)

Keys	Command	Description
`v`		starts visual mode
`V`		starts line-wise visual mode
	`Ctrl+v`	starts visual block mode
	`Esc` or `Ctrl+[`	exit visual mode
`O`		move to other corner of block

Cut and paste

Keys	Description
`y`	yank (copy) marked text
`d`	delete marked text
`c`	delete the marked text and go into insert mode (like c does above)
`yy`	yank (copy) a line
`p`	put (paste) the clipboard after cursor
`P`	put (paste) before cursor
`dd`	delete (cut) a line
`x`	delete (cut) current character
`X`	delete previous character (like backspace)

Exiting

Keys/Commands	Description
`:q[uit]`	Quit Vim. This fails when changes have been made
`:q[uit]!`	Quit without writing
`:cq[uit]`	Quit always, without writing
`:wq`	Write the current file and exit
`wq!`	Write the current file and exit always
`:wq {file}`	Write to {file}. Exit if not editing the last
`:wq! {file}`	Write to {file} and exit always
`:[range]wq[!] [file]`	Same as above, but only write the lines in [range]
`ZZ`	Write current file, if modified, and exit
`ZQ`	Quit current file and exit (same as `:q!`)

Marks

Marks allow you to jump to designated points in your code.

Keys	Description
`m{a-z}`	Set mark {a-z} at cursor position. A capital mark `{A-Z}` sets a global mark and will work between files
`‘{a-z}`	move the cursor to the start of the line where the mark was set
`‘’`	go back to the previous jump location

Split Windows

Keys	Command	Description
`Ctrl-wn`	`:new`	new horizontal split (editing a new empty buffer)
`Ctrl-ws`	`:split`	split window horizontally (editing current buffer)
`Ctrl-wv`	`:vsplit` or `:vsp`	split window vertically (editing current buffer)
`Ctrl-wc`	`:close`	close window
`Ctrl-wo`	`:only`	close all windows, leaving :only the current window open
`Ctrl-ww`		go to next window
`Ctrl-wp`		go to previous window
`Ctrl-wq`	`:exit`	quit a window
`Ctrl-w<Up>`		go to window above
`Ctrl-w<Down>`		go to window below
`Ctrl-w<Left>`		go to window on left
`Ctrl-w<Right>`		go to window on right

:vsplit {filename} use the filename for the split command

Tabs

Keys	Command	Description
	`:tabe`	Make a new tab
	`:tabnew`	To open an existing file in a new tab
	`:tabedit [FILENAME]`	To open an existing file in a new tab
`Ctrl-PageDown` or `gt`	`:tabn`	next tab
`Ctrl-PageUp` or `gT`	`:tabp`	previous tab
	`:tabc`	close current tab
	`:tabo`	close all other tabs leaving ONLY the current tab open

Edit this page

vi

Introduction#

command line#

Terms#

Editing a file#

General#

Cursor movement (Inside command/normal mode)#

Search and Replace#

Insert/Appending/Editing Text#

Marking text (visual mode)#

Cut and paste#

Exiting#

Marks#

Split Windows#

Tabs#