vim

Movement

Searching

Jumping to characters

f{char} - move to the next occurrence of {char} to the right of the cursor on the same line

F{char} - move to the next occurrence of {char} to the left of the cursor on the same line

t{char} - move to the left of the next occurrence of {char} to the right of the cursor on the same line

T{char} - move to the right of next occurrence of {char} to the left of the cursor on the same line

Jump forward / backward between the ‘results’ via ; and ,.

Further you can search for whole words via /<searchterm>Enter.


Searching for strings

* - move to the next occurrence of the word under the cursor

# - move to the previous occurrence of the word under the cursor

/searchtermEnter brings you to next match (forward-search). If you use ? instead of /, searching goes backwards.

Jump between the matches via n (next) and N (previous).

To view/edit your previous searches, type / and hit the up arrow key.

Helpful are also these settings: (note :se is equal to :set)

  • :se hls HighLightSearch, highlights all search matches; use :noh for temporarily turning off the search/mark highlighting (:set noh or :set nohls turns off.)
  • :se is or :set incs turns Incremental Search on, cursor jumps to the next match automatically. (:se nois turns off.)
  • :se ic IgnoreCase, turns case sensitivity off. (:se noic turns on again.)
  • :se scs SmartCaSe, can be used when IgnoreCase is set; makes case (in)sensitivity smart! e.g. /the will search for the, The, ThE, etc. while /The only will look for The.

Basic Motion

Remarks

  • Every motion can be used after an operator command, so the command operates on the text comprised by the movement’s reach.
  • Just like operator commands, motions can include a count, so you can move by 2words, for example.

Arrows

In Vim, normal arrow/cursor keys () work as expected. However, for touch-typers, it’s easier to use the hjkl alternative keys. On a typical keyboard, they’re located next to each other on the same row, and easily accessible using right hand. The mnemonic technique to remember which is which among them goes like this:

  • h/l — those are located “most to the left/right” among the four letters on the keyboard, so they are equivalent to “going left/right” respectively;
  • j — lowercase “j” has its tail going “down” below typical letters, like a small arrow - so it’s equivalent to “going down”;
  • k — conversely, lowercase “k” has its “ascender” going “up” above typical letters, like a small pointer - so it’s equivalent to “going up”.

Basic motions

All commands below should be done in normal mode.

Command Description
h or left go [count] characters to the left
j or down go [count] characters below
k or up go [count] characters above
l or right go [count] characters to the right
gg go the first line, or [count]‘th line, if given
H go to the first line in the visible screen
M go to the middle line in the visible screen
L go to the last line in the visible screen
G go the last line, or [count]‘th line, if given
Home or 0 go to first character of the line
^ go to first non-blank character of the line
+ go down one line to first non-blank character
- go up one line to first non-blank character
$ or End go to the end of the line (if [count] is given, go [count - 1] lines down)
| go to the [count]‘th character or go to the beginning of the line if count not specified
f{char} go to [count]‘th occurrence of {char} to the right inclusive
F{char} go to [count]‘th occurrence of {char} to the left inclusive
t{char} go to [count]‘th occurrence of {char} to the right exclusive
T{char} go to [count]‘th occurrence of {char} to the left exclusive
; repeat latest f, t, F or T [count] times
, repeat latest f, t, F or T, in the opposite direction, [count] times
w go to the beginning of the next word
b go to the beginning of the previous word
e go to the ending of the next word
ge go to the ending of the previous word
% go to matching pairs, e.g (), [], {}, /* */ or #if, #ifdef, #else, #elif, #endif
{ } previous/next paragraph
[{]} beginning/ending of block
‘{char} Go to mark (mark with m{char})
<C-B><C-F> previous/next page
<C-O><C-I> Go back or foward in the “jump list” (requires jumplist feature, see :help jumps)

Note: b, e, and w consider a word to be letters, numbers, and underscores by default (this can be configured with the iskeyword setting). Each of these can also be capitalized, causing them to skip over anything that isn’t whitespace as well.

Note: Vim recognizes two kinds of movement: operator movement (:help movement) and jumps (:help jumplist). Movements like those executed with g (gg, G, g,) count as jumps, as do changes. Changes get their own jumplist, which is navigable as mentioned above via g, and g; (see :help changelist). Jumps are not treated as motion commands by Vim

When moving up or down across lines, the cursor retains its column as would be expected. If the new line is too short the cursor moves to the end of the new line. If the column is beyond the end of the line, the cursor is displayed at the end of the line. The initial column number is still retained until an action is taken to alter it (such as editing text or explicitly moving column).

If a line’s length exceeds the width of the screen, the text is wrapped (under default settings, this behaviour can be configured). To move through lines as displayed on screen, rather than lines within the file, add g in front of the usual command. For example, gj will move the cursor to the position displayed one line below its current position, even if this is in the same line of the file.

Searching For Pattern

Vim supports the use of regular expressions when searching through a file.

The character to indicate that you wish to perform a search is /.

The simplest search you can perform is the following

/if

This will search the entire file for all instances of if. However, our search if is actually a regular expression that will match any occurrence of the word if including those inside of other words.

For instance, our search would say all of the following words match our search: if, spiffy, endif, etc.

We can do more complicated searches by using more complicated regular expressions.

If our search was:

/\<if\>

then our search would only return exact matches to the full word if. The above spiffy and endif would not be returned by the search, only if.

We can also use ranges. Given a file:

hello1
hello2
hello3
hello4

If we want to search for those lines containing “hello” followed by a digit between 1 and 3 we would say:

/hello[1-3]

Another example:

/(?:\d*\.)?\d+

would find all of the integer and decimals numbers in the file.

Navigating to the beginning of a specific word

When editing text, a common task is to navigate to a particular word on the screen. In these examples we explore how we can navigate to the word updated. For the sake of consistency across the examples, we aim to land on the first letter of the word.


Mid-screen jump
M$B

enter image description here

This approach is quick, using only 3 keystrokes. The disadvantage however, is that it is not very general, as it’s not common for our target line to happen to lie right on the middle of the screen. Still, it is a useful motion when making less granular movements.


Using a count
3jfu;;

enter image description here

At first glance, this may appear to be a step back from the first approach because of the number of keystrokes. But since we use a count here instead of M, it is more flexible. We can quickly identify the correct count to use if relativenumber is enabled. To move to the target word, using f in combination with ; can be surprisingly effective - and certainly better than repeatedly pressing w. If you overshoot your target with ;, you can go backwards with ,.


Explicit search
/upEnternn

enter image description here

Navigating via / can be very powerful. We can often jump directly to our target word by typing it out. Here we type out only the first two characters in the hope that it uniquely matches our word. Unfortunately, there are multiple matches, but we can quickly jump to the next match with n.


Implicit search
/ySpaceEnterw

enter image description here

In some cases, it may be more efficient to jump near our target rather than aiming to go directly to it. Here we observe that there is an infrequently occurring letter, y, right next to the target. We can add a Space to our search term to decrease the chances that we hit some other y character along the way. This can also be used to great effect with f{char}, as in the example Using a count.

Using Marks to Move Around

Marks are like bookmarks; they help you find places you’ve already been.

TLDR

Set them in normal mode with m{a-zA-Z}, and jump to them in normal or visual mode with '{a-zA-Z} (single quote) or `{a-zA-Z} (backtick). Lowercase letters are for marks within a buffer, and capital letters and digits are global. See your currently set marks with :marks, and for more info see :help mark.

Set a mark

Vim’s built-in help says:

m{a-zA-Z}               Set mark {a-zA-Z} at cursor position (does not move
                        the cursor, this is not a motion command).

The mark will keep track of which line and column it was placed at. There is no visual confirmation that a mark was set, or if a mark had a previous value and has been overwritten.

Jump to a mark

Vim’s built-in help says:

Jumping to a mark can be done in two ways:  
1. With ` (backtick):     The cursor is positioned at the specified location
                          and the motion is exclusive.
2. With ' (single quote): The cursor is positioned on the first non-blank
                          character in the line of the specified location and
                          the motion is linewise.

Backtick uses the column position, while Single-quote does not. The difference between simply allows you to ignore the column position of your mark if you want.

You can jump between non-global marks in visual mode in addition to normal mode, to allow for selecting text based on marks.

Global Marks

Global marks (capital letters) allow for jumping between files. What that means is if, for example, mark A is set in foo.txt, then from bar.txt (anywhere in my filesystem), if I jump to mark A, my current buffer will be replaced with foo.txt. Vim will prompt to save changes.

Jumping to a mark in another file is not considered to be a movement, and visual selections (among other things) will not work like jumping to marks within a buffer.

To go back to the previous file (bar.txt in this case), use :b[uffer] # (that is, :b# or :buffer#).

Note:

Special marks

There are certain marks that Vim sets automatically (which you are able to overwrite yourself, but probably won’t need to).

For example (paraphrased from Vim’s help):

`[` and `]`: jump to the first or last character of the previously changed or 
             yanked text.  {not in Vi}

`<` and `>`: jump to the first or last line (with `'`) or character (with 
             <code>`</code>) of the last selected Visual area in the current 
             buffer.  For block mode it may also be the last character in the 
             first line (to be able to define the block).  {not in Vi}.

More, from Vim’s built-in help:

''  ``              To the position before the latest jump, or where the
                    last "m'" or "m`" command was given.  Not set when the
                    :keepjumps command modifier was used.
                    Also see restore-position.


'"  `"              To the cursor position when last exiting the current
                    buffer.  Defaults to the first character of the first
                    line.  See last-position-jump for how to use this
                    for each opened file.
                    Only one position is remembered per buffer, not one
                    for each window.  As long as the buffer is visible in
                    a window the position won't be changed.
                    {not in Vi}.

'.  `.              To the position where the last change was made.  The
                    position is at or near where the change started.
                    Sometimes a command is executed as several changes,
                    then the position can be near the end of what the
                    command changed.  For example when inserting a word,
                    the position will be on the last character.
                    {not in Vi}

'"  `"              To the cursor position when last exiting the current
                    buffer.  Defaults to the first character of the first
                    line.  See last-position-jump for how to use this
                    for each opened file.
                    Only one position is remembered per buffer, not one
                    for each window.  As long as the buffer is visible in
                    a window the position won't be changed.
                    {not in Vi}.

'^  `^              To the position where the cursor was the last time
                    when Insert mode was stopped.  This is used by the
                    gi command.  Not set when the :keepjumps command
                    modifier was used.  {not in Vi}

Additionally, the characters (,),{, and } are marks which jump to the same position as would their normal-mode commands – that is, '} does the same thing in normal mode as }.

Jump to specific line

To jump to a specific line with colon number. To jump to the first line of a file use

:1

To jump to line 23

:23

This modified text is an extract of the original Stack Overflow Documentation created by the contributors and released under CC BY-SA 3.0 This website is not affiliated with Stack Overflow