VI (Visual) Editor Reference manual

The vi is a text editor. It is small, powerful, and standard on most UNIX systems. The vi often frustrates new users with a unique distinction between its two modes: Command Mode and Insert/Overtype Mode. This distinction, although difficult to become accustomed to for many users, provides great power and ability to the editor. Insert/Overtype Mode is designed for inserting text only. All text manipulations and cursor moving should be done from with in Command Mode.

Entering the vi

  • prompt$ vi
  • prompt$ vi file1 file2 ...
  • prompt$ vi -r file #Recover file from crash
  • prompt$ vi +string file #Execute ex command "string"
  • prompt$ vi @rcfile #Read commands from rcfile
  • Insert/Overtype Mode

    Insert/Overtype Mode is solely for entering text. To leave one of these two modes press the [ESC] key. if you wish to enter the ESC character or any other control character while in insert mode: type [CONTROL]-V and then the control sequence. The only difference between Insert Mode and Overtype Mode is that characters are placed in front of the text after the cursor in Insert Mode, where as existing characters are overwritten in Overtype Mode.

    Command Mode

    Entering Insert Mode

  • a — append text, after the cursor
  • i — insert text, before the cursor
  • R — enter Overtype Mode
  • A — append text, after end of line
  • I — insert text, before first non-whitespace character
  • o — open new line below cursor in Insert Mode
  • O — open new line above cursor in Insert Mode
  • vi Syntax

    vi commands follow the general form:
    n operator m object
    which means:
    execute operator n times on m objects. If n and/or m are omitted, they default to 1.
    Operators which take objects are(if the operator is pressed twice then the object is the current line)
  • c — change
  • d — delete
  • "cy — yank into buffer c; uses general buffer if "c is omitted
  • < — shift lines left by shiftwidth variable
  • > — shift lines right by shiftwidth variable
  • !cmd — filter through cmd
  • #The operators <, >, and ! are line based so the set of objects is diminished greatly.
    Operators which do not take objects:
  • s — substitute
  • x — delete character
  • r — replace character
  • ~ — change case of character
  • Objects (if given without an operator, these interpreted as a cursor motion command):
  • w — forward until beginning of word
  • e — forward until end of word
  • b — backward until beginning of word
  • $ — forward until end of line
  • ^ — backward until first non-whitespace character
  • 0 — backward until first column of line
  • nG — line number n (default: $, i.e. last line of file)
  • n| — column n of current line
  • /pat — forward to pattern pat
  • ?pat — backward to pattern pat
  • n — forward to target of last search
  • N — to target of last search, but in opposite direction
  • % — to matching parenthesis, brace, or bracket (forward or backward)
  • fc — forward on current line to c
  • Fc — backward on current line to c
  • tc — forward on current line to before c
  • Tc — backward on current line to after c
  • ; — repeat last f, F, t, or T
  • , — repeat last f, F, t, or T in reverse
  • } — forward to end of paragraph
  • { — backward to end of paragraph
  • ) — forward to end of sentence
  • ( — backward to end of sentence
  • ]] — forward to end of section
  • [[ — backward to end of section
  • nHn lines before first line on screen; n defaults to 0
  • nLn lines before last line on screen; n defaults to 0
  • M — the middle line of the screen
  • j — down one line
  • k — up one line
  • h — left one character
  • l — right one character
  • [BS] — left one character, backspace usually equals ^H
  • [SPACE] — right one character
  • _ (underscore) — the entire current line
  • - (dash) — until first non-whitespace character on previous line
  • + — until first non-whitespace character on next line
  • [RETURN] — until first non-whitespace character on next line
  • Miscellaneous

  • u — undo last change
  • U — undo entire line
  • "cp — put "c or general buffer after the cursor
  • "cP — put "c or general buffer before the cursor
  • mc — set mark with character c
  • `c — goto mark c
  • 'c — goto beginning of line with mark c
  • `` — return to position before mark jump or search
  • '' — return to beginning of line before mark jump or search
  • J — join two lines
  • D — delete rest of line
  • C — change rest of line
  • Y — yank current line into general buffer
  • & — execute last ex-style substitution
  • . — execute last modification
  • ! object command — send object as stdin to command and replace with stdout
  • [Ctrl]-G — print information about file
  • : map x y — when character x is pressed, execute y
  • : map! x y — map input mode character x to string y
  • : ab x yx is an abbreviation for y, changes are made on the fly
  • : su — Suspend the current editor session
  • : sh — run a shell
  • ex Commands

    ex syntax

    ex commands in the vi follow this general form:
    : address command
    which means:
    Execute command on specific lines obtained from the address part of the general form. If address is omitted, current line is used. Keep in mind that the ex is a line based editor, so all actions are line based.
    addresses:
  • % — all lines in file
  • x,y — lines x to y
  • . — current line
  • n — line number: n
  • $ — last line of file
  • x-nn lines before line x
  • x+nn lines after line x
  • /pat/ — forward to line containing pat
  • ?pat? — backward to line containing pat
  • Some commands:
  • s/pat/text/ — substitute first match of pat with text
  • s/pat/text/g — substitute every match of pat with text
  • s/pat/text/n — substitute the nth occurrence of pat with text
  • y c — yank into buffer c or the general buffer if c is omitted (example)
  • ya c — yank into buffer c or the general buffer if c is omitted (example)
  • g address cmd — execute cmd on all lines which satisfy address
  • > — shift right
  • < — shift left
  • d — delete line
  • ! UNIX-cmd — execute UNIX-cmd on line
  • m address — move lines to address
  • refer to ex manual page for more commands
  • The vi environment variables

    set
    You can customize your environment with this command by typing set var=value, this will set the specified var to value for a scalar variable. For boolean variables, use set var to set and set novar to unset. You can see which variables are set by just typing the set by its self. You can see a list of all variables by typing set all. Some environment variables are specific to the ex editor and some are specific to the vi editor. I have included both.
    boolean variables:
  • autoindent (ai) — begin editing next line at same level of indent-ion as this one.
  • autowrite (aw) — write current buffer before leaving
  • exrc (ex) — tells vi/ex if it should read the .exrc file in the current directory.
  • errorbells — editor sends a beep to the terminal when an incorrect
  • ignorecase (ic) — ignore case of characters in searches.
  • list — place a $ at the end of each line and a ^I on each tab.
  • magic — allow ., [, and * to be interpreted as special characters in regular expressions.
  • number (nu) — number lines in left margin
  • showmatch (sm) — when closing a paren., brace or bracket; move the visual cursor to opening item to check scope
  • showmode (smd) — show type of insert mode
  • wrapscan (ws) — when searching and at bottom of file, continue searching from the top
  • scalar variables:
  • shiftwidth (sw) — number of spaces to to insert on a shift operation
  • File Saving and Loading

  • : wq — write file and quit
  • : w — write file
  • : w file — write to specified file
  • : w! — overwrite existing file
  • : e file — edit new file
  • : r file — put contents of file
  • : q — quit the editor
  • : q! — force quit the editor, do not save changes
  • : x — quit the editor, save file if it was modified
  • ZZ — quit the editor, save file if it was modified
  • : n — start editing next file in list
  • : rew — rewind file list, start editing first file on argument list again
  • Q — quit vi and enter ex
  • : pre file — preserve file : write all text for all buffers into swap file
  • : rec file — try to recover file from swap file
  • Examples

    vi commands:
  • j — move cursor down
  • k — move cursor up
  • h = [BS] — move cursor left
  • l = [SPACE] — move cursor right
  • + = [RETURN] — first non-whitespace character on next line
  • cw — change word
  • dd = d_ — delete line
  • yy = y_ — yank current line into the general buffer
  • "ayj — yank current line and one below into buffer a
  • yfc — yank until next occurrence of c on current line into the general buffer
  • 3dl = d3l — delete next 3 characters
  • 2dj = d2j — delete current and next 2 lines
  • 4c( = 2c2( = c4( — change next 4 sentences
  • >% — while on a brace, paren., or bracket; shift right until closing brace, etc.
  • 3J — join next 2 lines to current line
  • ex commands:
  • :%!sort = :1,$!sort — sort current file
  • :5,10s/foo/bar/2 — change the second occurrence of foo with bar on lines 5-10
  • :map g 1G — map g to really run 1G
  • :?foo?,/bar/d — delete from the reverse match of foo until the next match of bar
  • :g/{/,/}/< — shift left all lines between, and including, a { and }
  • :$-4,$d — delete last five lines of buffer
  • :%s/^\(.*\) \(.*\)$/\2 \1/ — swap everything before and after the first space
  • :10,20y g — yank lines 10-20 into buffer g (descripton)
  • :23,45ya k — yank lines 23-45 into buffer k (descripton)
  • :'a,'by c — yank lines with mark a and mark b into buffer c
  • :3,9m$ — move lines 3 through 9 to the end of the file
  • :j3 — join next 2 lines to current line
  • :ab w/o with out — abbreviation: when w/o is typed, change to with out

  • Copyleft: (C) 1996 2000, William Totten

    Fred Vetter