How do I insert a linebreak where the cursor is without entering into insert mode in Vim?

Viewed 44263

Is possible to insert a line break where the cursor is in Vim without entering into insert mode? Here's an example ([x] means cursor is on x):

if (some_condition) {[ ]return; }

Occasionally, I might want to enter some more code. So I'd press i to get into insert mode, press Enter to insert the line break and then delete the extra space. Next, I'd enter normal mode and position the cursor before the closing brace and then do the same thing to get it on its own line.

I've been doing this a while, but there's surely a better way to do it?

15 Answers

For the example you've given, you could use rEnter to replace a single character (the space) with Enter. Then, fspace. to move forward to the next space and repeat the last command.

Depending on your autoindent settings, the above may or may not indent the return statement properly. If not, then use sEnterTabEsc instead to replace the space with a newline, indent the line, and exit insert mode. You would have to replace the second space with a different command so you couldn't use '.' in this case.

A simple mapping to break the line at the cursor by pressing Ctrl+Enter:

:nmap <c-cr> i<cr><Esc>

essentially enters 'insert' mode, inserts a line break and goes back to normal mode.

put it in your .vimrc file for future use.

Here's how to create a macro that inserts a newline at the cursor whenever you press 'g' while not in insert mode:

From within vim, type:

:map g i[Ctrl+V][Enter][Ctrl+V][Esc][Enter]

Where:

  • [Ctrl+V] means hold the Ctrl key and press 'v'
  • [Enter] means press the Enter key
  • [Esc] means press the Esc key

You'll see the following at the bottom of your vim window until you press the final Enter:

:map g i^M^[

Explanation:

[Ctrl+V] means "quote the following character" -- it allows you to embed the newline and escape characters in the command.

So you're mapping the 'g' key to the sequence:

i [Enter] [Escape]

This is vim for insert a newline before the cursor, then exit insert mode.

Tweaks:

  • You can replace the 'g' with any character that's not already linked to a command you use.
  • Add more to the command, e.g. f}i^M^[O -- This will find the } and insert another newline, then escape from insert mode and Open an empty line for you to enter more code.
  • You can add the command to your .vimrc or .exrc file to make it permanent. Just omit the colon from the beginning, so the command starts with "map"

Enjoy!

If you're usually expanding a one line block to three lines, try substitution. Change the opening bracket into bracket/return, and the closing bracket into return/bracket.

The command for substituting bracket/return for bracket looks like this:

:s/{/{\r/

Since you want to use this often, you could map the full sequence to an unused keystroke like this:

:map <F7> :s/{/{\r/ ^M :s/}/\r}/ ^M

Where you see ^M in the sequence, type [Ctrl-V], then press enter.

Now with your cursor anywhere on your sample line, press the mapped key, and the carriage returns are added.

Check :help map-which-keys for advice on selecting unused keystrokes to map.

Vim will automatically kill any whitespace to the right of the cursor if you break a line in two while autoindent (or any other indentation aid) is enabled.

If you do not want to use any of those settings, use s instead of i in order to substitute your new text for the blank rather than just inserting. (If there are multiple blanks, put the cursor on the leftmost and use cw instead.)

o ESC command will do it for you.

I found this to be the most faithful implementation of what I'd expect the opposite behaviour to J

nnoremap S i<cr><esc>^mwgk:silent! s/\v +$//<cr>:noh<cr>`w

It does the simplistic new line at cursor, takes care of any trailing whitespace on the previous line if there are any present and then returns the cursor to the correct position.

i <cr> <esc> - this is one of the most common solutions suggested, it doesn't delete non-whitespace characters under your cursor but it also leaves you with trailing whitespace

^mw - goto start of new line and create a mark under w

gk - go up one line

:silent! s/\v +$//<cr> - regex replace any whitespace at the end of the line

:noh<cr> - Clear any search highlighting that the regex might have turned on

`w - return the the mark under w

Essentially combines the best of both r<esc><cr> and i<cr><esc>

Note: I have this bound to S which potentially overwrites a useful key but it is a synonym for cc and since I don't use it as often as I do splits I am okay with overwriting it.

This mapping will break up any one-line function you have. Simply put your cursor on the line and hit 'g' in normal mode:

:map g ^f{malr<CR>`a%hr<CR>`a

This assumes that you have a space after the opening brace and a space before the closing brace. See if that works for you.

Related