tldr/pages/common/vim.md

# vim

> Vim (Vi IMproved), a programmer's command-line text editor, provides several modes for different kinds of text manipulation.
> Pressing `i` enters edit mode. `<Esc>` goes back to normal mode, which doesn't allow regular text insertion.
> More information: <https://www.vim.org>.

- Open a file:

`vim {{path/to/file}}`

- Save a file:

`:write`

- Quit without saving:

`<Esc>:quit!<Enter>`

- Open a file at a specified line number:

`vim +{{line_number}} {{path/to/file}}`

- View help for setting (such as {{set number}}):

`<Esc>:help '{{setting_name}}'`

- Undo the last operation:

`<Esc>u`

- Search for a pattern in the file (press `n`/`N` to go to next/previous match):

`<Esc>/{{search_pattern}}<Enter>`

- Perform a regex substitution in the whole file:

`<Esc>:%s/{{pattern}}/{{replacement}}/g<Enter>`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00			`# vim`

vim: helpful additions Closes #3779 2020-01-22 16:38:21 -07:00			`> Vim (Vi IMproved), a programmer's command-line text editor, provides several modes for different kinds of text manipulation.`
vim: Normal mode is the normal mode (#1106) * vim: Improvements we can can agree on Remove spaces between keypresses (as it could lead users to think they should type a space there). Simplify regexp substitution example. Add ...then... to search example. Add quit without saving example. * vim: Improvements we can can agree on Move search keystrokes to the example title. Keep original regexp substitution example. See conversation starting at https://github.com/tldr-pages/tldr/pull/1106/commits/ee1472e76f2c3241a2f4bb96a56b824af724c64c#r82820204 2016-10-11 22:28:22 -05:00			> Pressing `i` enters edit mode. `<Esc>` goes back to normal mode, which doesn't allow regular text insertion.
Refactor: reword English pages' links' descriptions. 2019-06-03 02:06:36 +02:00			`> More information: <https://www.vim.org>.`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: improve examples (#1105) I tried to condense the most useful basic commands into this page without surpassing our length limit. I also expanded the main description -- I wonder if there's a way to phrase it which could allow us to get rid of all the <Esc>s... I combined copy/cut/paste into a single command, since it was important to allow space for a slightly more advanced command, (the find/replace example), which introduces some important vim concepts, such as command application ranges. 2016-10-06 11:19:06 +01:00			`- Open a file:`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: helpful additions Closes #3779 2020-01-22 16:38:21 -07:00			`vim {{path/to/file}}`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: helpful additions Closes #3779 2020-01-22 16:38:21 -07:00			`- Save a file:`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: helpful additions Closes #3779 2020-01-22 16:38:21 -07:00			`:write`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: helpful additions Closes #3779 2020-01-22 16:38:21 -07:00			`- Quit without saving:`

			`<Esc>:quit!<Enter>`

			`- Open a file at a specified line number:`

			`vim +{{line_number}} {{path/to/file}}`

			`- View help for setting (such as {{set number}}):`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: helpful additions Closes #3779 2020-01-22 16:38:21 -07:00			`<Esc>:help '{{setting_name}}'`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: improve examples (#1105) I tried to condense the most useful basic commands into this page without surpassing our length limit. I also expanded the main description -- I wonder if there's a way to phrase it which could allow us to get rid of all the <Esc>s... I combined copy/cut/paste into a single command, since it was important to allow space for a slightly more advanced command, (the find/replace example), which introduces some important vim concepts, such as command application ranges. 2016-10-06 11:19:06 +01:00			`- Undo the last operation:`
Add pages for vim and vimtutor 2015-12-28 13:06:58 +01:00
vim: Normal mode is the normal mode (#1106) * vim: Improvements we can can agree on Remove spaces between keypresses (as it could lead users to think they should type a space there). Simplify regexp substitution example. Add ...then... to search example. Add quit without saving example. * vim: Improvements we can can agree on Move search keystrokes to the example title. Keep original regexp substitution example. See conversation starting at https://github.com/tldr-pages/tldr/pull/1106/commits/ee1472e76f2c3241a2f4bb96a56b824af724c64c#r82820204 2016-10-11 22:28:22 -05:00			`<Esc>u`
vim: add :w, :wq, i 2015-12-29 12:09:30 -05:00
vim: Normal mode is the normal mode (#1106) * vim: Improvements we can can agree on Remove spaces between keypresses (as it could lead users to think they should type a space there). Simplify regexp substitution example. Add ...then... to search example. Add quit without saving example. * vim: Improvements we can can agree on Move search keystrokes to the example title. Keep original regexp substitution example. See conversation starting at https://github.com/tldr-pages/tldr/pull/1106/commits/ee1472e76f2c3241a2f4bb96a56b824af724c64c#r82820204 2016-10-11 22:28:22 -05:00			- Search for a pattern in the file (press `n`/`N` to go to next/previous match):
vim: add :w, :wq, i 2015-12-29 12:09:30 -05:00
vim: Normal mode is the normal mode (#1106) * vim: Improvements we can can agree on Remove spaces between keypresses (as it could lead users to think they should type a space there). Simplify regexp substitution example. Add ...then... to search example. Add quit without saving example. * vim: Improvements we can can agree on Move search keystrokes to the example title. Keep original regexp substitution example. See conversation starting at https://github.com/tldr-pages/tldr/pull/1106/commits/ee1472e76f2c3241a2f4bb96a56b824af724c64c#r82820204 2016-10-11 22:28:22 -05:00			`<Esc>/{{search_pattern}}<Enter>`
vim: add :w, :wq, i 2015-12-29 12:09:30 -05:00
vim: remove wrongly description of % 2017-10-21 22:01:49 +02:00			`- Perform a regex substitution in the whole file:`
reduced repetetiveness of descriptions 2016-01-05 17:07:51 -05:00
vim: add s for substitution 2017-10-19 19:27:18 +02:00			`<Esc>:%s/{{pattern}}/{{replacement}}/g<Enter>`