# A short guide to vim

> A short, beginner-friendly guide to the vim editor: how to open files, switch between command and insert mode, move around, edit text, and save and quit.

Author: [Flavio Copes](https://flaviocopes.com/about/) | Published: 2020-11-02 | Topics: [CLI](https://flaviocopes.com/tags/cli/) | Canonical: https://flaviocopes.com/linux-command-vim/

`vim` is a **very** popular file editor, especially among programmers. It's actively developed and frequently updated, and there's a very big community around it. There's even a [Vim conference](https://vimconf.org/)!

`vi` in modern systems is just an alias to `vim`, which means `vi` i`m`proved.

You start it by running `vi` on the command line.

![Vim startup screen showing VIM - Vi IMproved version 8.0.1283 with help commands and exit instructions](https://flaviocopes.com/images/linux-command-vim/Screenshot_2019-02-10_at_11.44.36.png)

You can specify a filename at invocation time to edit that specific file:

```bash
vi test.txt
```

![Vim editor opened with test.txt file showing empty document and New File status at bottom](https://flaviocopes.com/images/linux-command-vim/Screenshot_2019-02-10_at_11.36.21.png)

You have to know that Vim has 2 main modes:

- _command_ (or _normal_) mode
- _insert_ mode

When you start the editor, you are in command mode. You can't enter text like you expect from a GUI-based editor. You have to enter **insert mode**. You can do this by pressing the `i` key. Once you do so, the `-- INSERT --` word appear at the bottom of the editor:

![Vim editor in insert mode showing INSERT indicator at the bottom of the screen](https://flaviocopes.com/images/linux-command-vim/Screenshot_2019-02-10_at_11.47.39.png)

Now you can start typing and filling the screen with the file contents:

![Vim editor with sample text typed in insert mode showing Hey This is a very cool editor Its called Vim](https://flaviocopes.com/images/linux-command-vim/Screenshot_2019-02-10_at_11.48.39.png)

You can move around the file with the arrow keys, or using the `h` - `j` - `k` - `l` keys. `h-l` for left-right, `j-k` for down-up.

Once you are done editing you can press the `esc` key to exit insert mode, and go back to **command mode**.

![Vim editor back in command mode with text displayed but no INSERT indicator at bottom](https://flaviocopes.com/images/linux-command-vim/Screenshot_2019-02-10_at_11.48.44.png)

At this point you can navigate the file, but you can't add content to it (and be careful which keys you press as they might be commands).

One thing you might want to do now is **saving the file**. You can do so by pressing `:` (colon), then `w`.

You can **save and quit** pressing `:` then `w` and `q`: `:wq`

You can **quit without saving**, pressing `:` then `q` and `!`: `:q!`

You can **undo** and edit by going to command mode and pressing `u`. You can **redo** (cancel an undo) by pressing `ctrl-r`.

Those are the basics of working with Vim. From here starts a rabbit hole we can't go into in this little introduction.

I will only mention those commands that will get you started editing with Vim:

- pressing the `x` key deletes the character currently highlighted
- pressing `A` goes at the end of the currently selected line
- press `0` to go to the start of the line
- go to the first character of a word and press `d` followed by `w` to delete that word. If you follow it with `e` instead of `w`, the white space before the next word is preserved
- use a number between `d` and `w` to delete more than 1 word, for example use `d3w` to delete 3 words forward
- press `d` followed by `d` to delete a whole entire line. Press `d` followed by `$` to delete the entire line from where the cursor is, until the end

To find out more about Vim I can recommend the [Vim FAQ](https://vimhelp.org/vim_faq.txt.html) and especially running the `vimtutor` command, which should already be installed in your system and will greatly help you start your `vim` explorations.