1525

I am making the effort to learn Vim.

When I paste code into my document from the clipboard, I get extra spaces at the start of each new line:

line
  line
    line

I know you can turn off auto indent but I can't get it to work because I have some other settings conflicting or something (which look pretty obvious in my .vimrc but don't seem to matter when I take them out).

How do I turn off auto indenting when I paste code but still have vim auto indent when I am writing code? Here is my .vimrc file:

set expandtab  
set tabstop=2  
set shiftwidth=2  
set autoindent  
set smartindent  
set bg=dark  
set nowrap  
4
  • 4
    FWIW, vim 8.0.210 adds native support for bracketed paste, so it will avoid indenting pasted text.
    – sh1
    Commented Nov 9, 2017 at 17:12
  • 2
    For new files in order to avoid fiddling with vim's paste/nopaste you can do cat > mynewfile.txt press Enter, paste your text, press Enter again, and then Ctr+D to save. The file is now created and you can edit it with vim mynewfile.txt.
    – ccpizza
    Commented Oct 6, 2019 at 19:22
  • the cat solution has one disadvantage : variables are changed to the value of that variable
    – Sloomy
    Commented Jul 11, 2022 at 19:58
  • several years ago this was never an issue ... seems the default behavior has changed as I always use very minimal vim customizations Commented Aug 25, 2022 at 16:00

27 Answers 27

2689

Update: Better answer here: https://stackoverflow.com/a/38258720/62202

To turn off autoindent when you paste code, there's a special "paste" mode.

Type

:set paste

Then paste your code. Note that the text in the tooltip now says -- INSERT (paste) --.

After you pasted your code, turn off the paste-mode, so that auto-indenting when you type works correctly again.

:set nopaste

However, I always found that cumbersome. That's why I map <F3> such that it can switch between paste and nopaste modes while editing the text! I add this to .vimrc

set pastetoggle=<F3>
18
  • 44
    This isn't any easier than :set noai followed by :set ai. The suggestion of :r! cat is shorter.
    – Leopd
    Commented May 26, 2010 at 21:34
  • 83
    I think set paste is easier, definitely. It is much more semantic than noai or even noautoindent, which is more important when typing "noai" and "paste" take about the same insignificant amount of time when you are proficient enough as a touch typist. Commented Feb 15, 2013 at 15:27
  • 54
    :set noai doesn't always work, depending on how the other indent-related settings are configured as per the OP. :set paste appears to be a shorthand for several settings all at once.
    – MarkHu
    Commented Apr 26, 2013 at 1:16
  • 15
    Late to the party, but set copyindent will take care of this for you seamlessly.
    – Matt Ryan
    Commented Feb 6, 2014 at 17:53
  • 38
    :set paste also disables other features like braces completion, which is also not wanted when pasting code. Commented Jun 6, 2014 at 11:07
303

To avoid undesired effects while pasting, there is an option that needs to be set:

set paste

A useful command to have in your .vimrc is set pastetoggle=<F10> or some other button, to easily toggle between paste and nopaste.

7
  • 13
    Finally! I kept typing :set paste / :set nopaste, how stupid! Thx.
    – imwilsonxu
    Commented Jul 3, 2013 at 2:19
  • 4
    from a practical point of view, your answer is more useful than the accepted answer
    – Lynob
    Commented Feb 4, 2015 at 18:13
  • 10
    Another option is to add a macro to your vimrc: nmap <silent> <leader>p :set paste<CR>"*p:set nopaste<CR>
    – Chris
    Commented May 10, 2015 at 7:42
  • Nice suggestion @Chris - single key sequence to paste without indentation issues!
    – RichVel
    Commented Oct 3, 2016 at 13:17
  • what if I never want to be in paste mode? is there a way to permanently disable?
    – maxwell
    Commented Feb 24, 2018 at 17:30
155

I usually use :r! cat and then paste ( shift + insert ) the content, and CTRL+D.

No need to enable & disable, direct usage.

6
  • I like this direct usage option. I'm still learning how to read vim syntax on web pages, though. What do your steps mean? In particular, supposing I have something on the system clipboard, what do I press to paste it into a document in vim?
    – jvriesem
    Commented Nov 4, 2015 at 20:55
  • 11
    This answer would be more helpful with information about why and how :r! cat works. Commented May 9, 2016 at 13:32
  • 16
    @KErlandsson, :r inserts the contents of a file into the current document. !cat says, run cat which essentially opens stdin (*nix shells) (shift + insert) or for some terminals, right mouse click will paste the contents of the clipboard to the terminal CTRL+D is end-of-file, so it close the :r !cat session.
    – Daniel
    Commented Sep 5, 2016 at 19:39
  • 1
    Is this 'direct', really? Than setting an option paste made solely for this purpose? @jvriesem This isn't a 'direct' option, if what I assume of your understanding of that word is correct.
    – 0xc0de
    Commented Oct 31, 2017 at 7:50
  • You can also use :r! cat then CTRL+SHIFT+V to paste in the terminal (then CTRL+D). Commented Jan 9, 2018 at 14:12
100

If you are working locally, you can paste from the system clipboard with the key sequence:

"+p

This is a proper vim command, so no need to worry about entering an insert mode or switching off autoindent first.

Of course if you are working remotely (console over SSH, for example) then this won't work and you should go the :set noai, insert mode, paste into console, leave insertmode, :set ai route as described elsewhere.

7
  • 13
    I write this answer ages ago. Nowadays I use :set paste and :set nopaste instead because despite being longer, it's easier to remember and I don't have to look it up every time! Commented Feb 6, 2013 at 2:49
  • 6
    In some embedded systems (based on busybox mainly) :set paste is not implemented, so :set noai should be used instead.
    – jcarballo
    Commented Aug 6, 2013 at 19:26
  • When you have a large text to copy, isn't it faster to use the + register instead? Commented Apr 14, 2014 at 14:35
  • 1
    @pedromanoel that only works when working locally. It won't work accessing vim over SSH, for example, if you copied something locally and want to paste it into vim which is in your SSH session. Commented Apr 15, 2014 at 0:24
  • 1
    @thomasrutter but I mapped this to <leader>p.. very useful!
    – Dane
    Commented Mar 7, 2018 at 11:06
88

While setting the paste mode with paste/nopaste/pastetoggle is perfectly fine, you still have to manually enable paste mode before pasting and disable paste mode after pasting. Being the lazy person that I am, below is the best solution that I've found so far, which automatically toggles the paste mode when you paste.

Here's a little trick that uses terminal's bracketed paste mode to automatically set/unset Vim's paste mode when you paste. Put following in your .vimrc:

let &t_SI .= "\<Esc>[?2004h"
let &t_EI .= "\<Esc>[?2004l"

inoremap <special> <expr> <Esc>[200~ XTermPasteBegin()

function! XTermPasteBegin()
  set pastetoggle=<Esc>[201~
  set paste
  return ""
endfunction

Now you can paste without explicitly turning paste mode on/off - it is handled automatically for you.

Source: Coderwall

Note: This solution doesn't work in WSL (Windows 10 Subsystem for Linux). If anyone has a solution for WSL, please update this answer or add it in the comments.

Tmux If using tmux, then the declarations need to be double escaped. The code for this is also in Coderwall

7
  • This is briliant. One thing though... With every paste I get a "0" (zero) charracter in the start of every paste. Any tip for that?
    – Julius Š.
    Commented Sep 25, 2018 at 8:28
  • also note in if using tmux then you need to double escape. Code for this is in Coderwall link in answer
    – Daithí
    Commented Feb 17, 2019 at 0:03
  • 4
    If you are even lazier and copy pasting above code into your .vimrc, do take care of the indentation of the function XTermPasteBegin().
    – k1133
    Commented Aug 27, 2019 at 10:41
  • 3
    I was curious how this worked, and so I searched for Paste Bracketing and found gitlab.com/gnachman/iterm2/-/wikis/Paste-Bracketing which explains that the t_SI and t_EI variables are enabling paste bracketing and disabling it. When paste bracketing is on, pasted text is prefixed by esc[200~ and followed by esc[201~.
    – PatS
    Commented Apr 1, 2020 at 20:44
  • Unfortunately, this mapping delays switching from insert mode to normal mode about half a second. Is there a way to reduce this delay?
    – Take
    Commented Dec 31, 2020 at 9:55
40

Mac users can avoid auto formatting by reading directly from the pasteboard with:

:r !pbpaste
3
  • 3
    This is an awesome response. When I do this, however, it hides the document (it looks like I'm back on the command line), but has the text on my clipboard. It prompts me to press enter, so I do, and it returns me back to my document without any changes. What happened, and how do I do what you are saying?
    – jvriesem
    Commented Nov 4, 2015 at 20:58
  • If you just type :.!pbpaste, this should work by replacing the current line with the output of the paste buffer. In general, vim allows you to pipe data that is in your current file to another program and replace the text with the output of the command. So :1,3!pbpaste replaces the first three lines of your file with the paste buffer. I use :.!ppjson to take a very long (unformatted JSON string) and format it and replace the long string with the formatted equivalent. ppjson is just a bash script that runs python -m json.tool.
    – PatS
    Commented Apr 1, 2020 at 19:41
  • On Linux, xsel --clipboard instead of pbpaste does the same thing. Commented Nov 14, 2021 at 16:56
29

I am a Python user who sometimes copy and paste into Vim. (I switched from Mac to Windows WSL) and this was one of the glitches that bothered me.

If you touch a script.py and then vi script.py, Vi will detect it is a Python script and tried to be helpful, autoindent, paste with extra indents, etc. This won't happen if you don't tell it is a Python script.

However, if that is already happening to you, the default autoindent could be a nightmare when you paste already fully indented code (see the tilted ladder shape below).

I tried three options and here are the results

set paste        # works perfect 
set noai         # still introduced extra whitespace
set noautoindent # still introduced extra whitespace

enter image description here enter image description here

2
  • same boat—did you end up setting a keyboard shortcut or using a plugin or something that is a viable option? Or just living with it :)
    – aadibajpai
    Commented Oct 10, 2020 at 0:37
  • 2
    @aadibajpai I put set pastetoggle=<F2> in my .vimrc so pressing F2 toggles paste on and off.
    – Stephen C
    Commented Oct 15, 2020 at 19:59
20

Here is a post by someone who figured out how to remap the paste event to automatically turn paste mode on and then back off. Works for me in tmux/iTerm on MacOSX.

2
  • 1
    Thanks for the tip. I also tracked down a plugin where the person has bundled up similar functionality - stackoverflow.com/a/36512548/255961.
    – studgeek
    Commented Apr 9, 2016 at 3:54
  • This seems to cause a string of 'eeeeeee' when I insert a piece of text from my clipboard.
    – John Jiang
    Commented Sep 16, 2018 at 5:23
20

I just put set clipboard=unnamed in my .vimrc. That makes the default paste buffer map to X's clipboard.

So, if I mark a bit of text in a terminal, I can simply press p to paste it in vim. Similarly, I can yank things in vim (e.g. YY to yank the current line into the buffer) and middle click in any window to paste it.

I don't know. I find it super convenient.

1
  • 1
    IMHO, this is the best answer, no need for toggling with F11 (which is preconfigured by default in vim). This works in macs OSX system, I don't know about the others.
    – LightMan
    Commented Jul 29, 2018 at 11:37
17

Add this to your ~/.vimrc and you will only have to press F2 before and after pasting:

set pastetoggle=<F2>
1
  • how to turn it off? forever, i no need to toggle it Commented Feb 3 at 19:04
14

Another answer I did not see until now:

:se paste noai
2
  • the command :set paste noai works for pasting in afterwards - do you know of a way to reformat already pasted in text?
    – serup
    Commented Mar 22, 2023 at 11:53
  • gg=G possibly
    – sjas
    Commented Sep 23, 2023 at 11:02
11

When working inside a terminal the vim-bracketed-paste vim plugin will automatically handle pastes without needing any keystrokes before or after the paste.

It works by detecting bracketed paste mode which is an escape sequence sent by "modern" x-term compatible terminals like iTerm2, gnome-terminal, and other terminals using libvte. As an added bonus it works also for tmux sessions. I am using it successfully with iTerm2 on a Mac connecting to a linux server and using tmux.

3
  • Beware of what it also notes further: Unfortunately, this means that they will also run the contents of the input buffer if there's a newline in anything you paste into the terminal.
    – 0xc0de
    Commented Oct 31, 2017 at 8:01
  • 1
    @0xc0de, that quote is not relevant here. That's talking about what a shell will do when it does not support bracketed paste mode. That's the point in bracketed paste mode -- to stop that from happening.
    – sh1
    Commented Nov 1, 2017 at 6:46
  • This worked much better for me than the other solutions. Thanks.
    – jjj
    Commented Nov 5, 2017 at 20:55
9

Stick this in your ~/.vimrc and be happy:

" enables :Paste to just do what you want
command Paste execute 'set noai | insert | set ai'

Edit: on reflection, :r !cat is a far better approach since it's short, semantic, and requires no custom vimrc. Use that instead!

0
7

Another way to paste is via <C-r> in insert mode and dropping the contents of the register (here the global register). See: :h i_ctrl-r and h i_CTRL-R_CTRL-O.

From the vim help documentation:

Insert the contents of a register literally and don't auto-indent. Does the same as pasting with the mouse. Does not replace characters! The '.' register (last inserted text) is still inserted as typed.{not in Vi}

So to paste contents into vim without auto indent, use <C-r><C-o>* in most unix systems.

You can add a mapping in the your vimrc inoremap <C-r> <C-r><C-o> so you can paste the contents of the * register normally without the auto indent by using <C-r>*.

Note: this only works if vim is compiled with clipboard.

2
  • Cheers, this is the best solution so far since I only have this problem with <C-r> for some reason, p in command mode is unaffected by this problem. Ideally it would be nice if <C-r> could simply behave like p, but this will do in the meantime! Commented Dec 11, 2020 at 19:41
  • Live will never be the same for me, thank you! Commented Nov 8, 2022 at 14:08
6

Although :pastetoggle or :paste and :nopaste should be working fine (if implemented - they are not always as we can see from the discussion) I highly recomment pasting using the direct approach "+p or "*p and reading with "+r or "*r:

Vim has acess to ten types of registers (:help registers) and the questioner is interested in quotestar and quoteplus from section

  1. Selection and drop registers "*, "+ and "~

Use these registers for storing and retrieving the selected text for the GUI. See quotestar and quoteplus. When the clipboard is not available or not working, the unnamed register is used instead. For Unix systems the clipboard is only available when the +xterm_clipboard feature is present. {not in Vi}

Note that there is only a distinction between "* and "+ for X11 systems.

:help x11-selection further clarifies the difference of * and +:

                                                  quoteplus quote+

There are three documented X selections: PRIMARY (which is expected to represent the current visual selection - as in Vim's Visual mode), SECONDARY (which is ill-defined) and CLIPBOARD (which is expected to be used for cut, copy and paste operations).

Of these three, Vim uses PRIMARY when reading and writing the "* register (hence when the X11 selections are available, Vim sets a default value for 'clipboard' of "autoselect"), and CLIPBOARD when reading and writing the "+ register. Vim does not access the SECONDARY selection.

Examples: (assuming the default option values)

  • Select an URL in Visual mode in Vim. Go to your browser and click the middle mouse button in the URL text field. The selected text will be inserted (hopefully!). Note: in Firefox you can set the middlemouse.contentLoadURL preference to true in about:config, then the selected URL will be used when pressing middle mouse button in most places in the window.

  • Select some text in your browser by dragging with the mouse. Go to Vim and press the middle mouse button: The selected text is inserted.

  • Select some text in Vim and do "+y. Go to your browser, select some text in a textfield by dragging with the mouse. Now use the right mouse button and select "Paste" from the popup menu. The selected text is overwritten by the text from Vim. Note that the text in the "+ register remains available when making a Visual selection, which makes other text available in the "* register. That allows overwriting selected text.
1
  • i have noticed using middle click in vim doesn't appear to mess up indentation so that might be an idea
    – Fuseteam
    Commented Feb 7, 2020 at 12:24
5

From vim: ]p

From outside: "*]p or "+]p

4

This works for me ( case for + register, what i use like exchange buffer between aps ):

imap <silent> <S-Insert> <C-O>:set noai<CR><C-R>+<C-O>:set ai<CR>
0
3

This issue has already been answered, but I though I could also add my own solution:

If you simply want to disable auto-indent system wise, for every file type (basically, disable the auto-indent feature completely), you can do the following:

  1. Backup the indent.vim file:
    sudo mv /usr/share/vim/vim81/indent.vim /usr/share/vim/vim81/indent.vim.orig
  2. Create a new empty indent.vim file:
    sudo touch /usr/share/vim/vim81/indent.vim
1
  • I actually prefer this solution, since it doesn't permanently alter vim's original settings.
    – Zak
    Commented Aug 30, 2022 at 20:35
2

If you are on a mac, macvim seems to handle it well without having to toggle paste.

brew install macvim --override-system-vim

1
  • Is that the case if you include the OP's directives in your .vimrc file? Commented Oct 12, 2014 at 21:58
2

Native paste / bracketed paste is the best and simplest way since vim 8 (released in 2016). It even works over ssh! (Bracketed paste works on Linux and Mac, but not Windows Git Bash)

  1. Make sure you have vim 8+ (you don't need the +clipboard or +xterm_clipboard options).

    vim --version | head -1

  2. Simply use the OS native paste command (e.g. ctrl+shift+V or cmd+V) in Normal Mode. Do not press i for Insert Mode.


Test

  1. Copy (ctrl+shift+C or cmd+C) the output of this (2 lines with a tab indent) to the system clipboard:

    echo -e '\ta\n\tb'

  2. Launch a clean vim 8+ with autoindent:

    vim -u NONE --noplugin -c 'set autoindent'

  3. Paste from the system clipboard (ctrl+shift+V or cmd+V) in Normal Mode. Do not press i for Insert Mode. The a and b should be aligned with a single tab indent. You can even do this while ssh-ing to a remote machine (the remote machine will need vim 8+).

  4. Now try the old way, which will autoindent the second line with an extra tab: Press i for Insert Mode. Then paste using ctrl+shift+V or cmd+V. The a and b are misaligned now.


Installing Vim 8

1
  • 1
    best and simplest way! Also, Google suggested it in Featured snippet for my search 'paste content no tabs vim', maybe because, I used 'tab' keyword, only in this answer mentioned :)
    – David
    Commented Jul 14, 2019 at 6:44
1

Please read this article: Toggle auto-indenting for code paste

Some people like the visual feedback shown in the status line by the following alternative for your vimrc:

nnoremap <F2> :set invpaste paste?<CR>
set pastetoggle=<F2>
set showmode
1

The fastest way I’m aware of to quickly go to paste-insert mode for a one-shot paste is tpope’s unimpaired, which features yo and yO, presumably mnemonics for “you open”. They’re only documented in his vimdoc, as:

A toggle has not been provided for 'paste' because the typical use case of wrapping of a solitary insertion is so wasteful: You toggle twice, but you only paste once (YOPO). Instead, press yo or yO to invoke o or O with 'paste' already set. Leaving insert mode sets 'nopaste' automatically.

1

The following vim plugin handles that automatically through its "Bracketed Paste" mode: https://github.com/wincent/terminus

Sets up "Bracketed Paste" mode, which means you can forget about manually setting the 'paste' option and simply go ahead and paste in any mode.

1

VimL:

inoremap <silent> <S-Insert> <Cmd>set paste<CR><C-r>+<Cmd>set nopaste<CR>

Neovim lua:

vim.keymap.set("i", "<S-Insert>", [[<Cmd>set paste<CR><C-r>+<Cmd>set nopaste<CR>]], { noremap = true, silent = true })
0

Sadly I found the vim plugin mentioned not to be working with iTerm2 3.0.15 (to be fair I don't know if this broke on older versions) - but I found this hack instead.

Map command-p to do the paste and using iTerm2 vim keys. Obviously this only works for iTerm2.

How it works. I use "jk" to enter escape mode so you will also need:

:inoremap jk

in your .vimrc.

Then it just invokes P to enter paste mode, "+p to paste from the clipboard and then P to disable paste mode. hth.

enter image description here

4
  • 1
    Wait, what, you use 'jk' for this?
    – 0xc0de
    Commented Oct 31, 2017 at 7:46
  • Oh yeah, I'd forgotten to mention that. Just add ":inoremap jk <esc>" to your .vimrc. As to why I use jk, ask Apple and why they felt the need to move and get rid of the physical escape key. 8(
    – Goblinhack
    Commented Oct 31, 2017 at 11:41
  • BTW it takes some training but after a while jk feels faster and I think I prefer it now over escape... Anyway would be interesting to know if iTerm2 accepts <ESC> here also.
    – Goblinhack
    Commented Oct 31, 2017 at 11:48
  • Way to go Apple!
    – 0xc0de
    Commented Nov 1, 2017 at 5:40
0

If you use the vim above v8.2, you can check with :help tmux-integration.

If you experience issues when running Vim inside tmux, here are a few hints. You can comment-out parts if something doesn't work (it may depend on the terminal that tmux is running in):

if !has('gui_running') && &term =~ '^\%(screen\|tmux\)'
    " Better mouse support, see  :help 'ttymouse'
    set ttymouse=sgr

    " Enable true colors, see  :help xterm-true-color
    let &termguicolors = v:true
    let &t_8f = "\<Esc>[38;2;%lu;%lu;%lum"
    let &t_8b = "\<Esc>[48;2;%lu;%lu;%lum"

    " Enable bracketed paste mode, see  :help xterm-bracketed-paste
    let &t_BE = "\<Esc>[?2004h"
    let &t_BD = "\<Esc>[?2004l"
    let &t_PS = "\<Esc>[200~"
    let &t_PE = "\<Esc>[201~"

    " Enable focus event tracking, see  :help xterm-focus-event
    let &t_fe = "\<Esc>[?1004h"
    let &t_fd = "\<Esc>[?1004l"

    " Enable modified arrow keys, see  :help xterm-modifier-keys
    execute "silent! set <xUp>=\<Esc>[@;*A"
    execute "silent! set <xDown>=\<Esc>[@;*B"
    execute "silent! set <xRight>=\<Esc>[@;*C"
    execute "silent! set <xLeft>=\<Esc>[@;*D"
endif
0

If you want to turn off autoindent forever,you can remove this file /usr/share/vim/vim82/indent.vim and add set paste to your vimrc file

Not the answer you're looking for? Browse other questions tagged or ask your own question.