SysTutorials

Pasting Text in Vim Without Auto-Indentation

· updated April 12, 2026

Pasting external code into Vim often triggers unwanted autoindent behavior, adding extra indentation and breaking formatting. Vim’s paste mode disables all automatic indentation while inserting text, letting you paste code exactly as-is.

Quick paste mode toggle

Enable paste mode before pasting:

:set paste

Then paste your code. When done, disable it:

:set nopaste

This works, but typing the full commands repeatedly is tedious. A better approach uses the pastetoggle option.

Using pastetoggle for efficiency

Add this to ~/.vimrc:

set pastetoggle=<F2>

Now you can toggle paste mode instantly with a single keystroke:

  1. Press F2 to enable paste mode (still in normal mode)
  2. Enter insert mode with i or a
  3. Paste your code
  4. Press Escape to exit insert mode
  5. Press F2 again to disable paste mode

You can bind the toggle to any key you prefer. Common alternatives include:

set pastetoggle=<C-p>
set pastetoggle=<Leader>p

Modern alternative: bracketed paste

If you’re using a terminal that supports bracketed paste (most do in 2026), Vim can detect paste events automatically. Add this to ~/.vimrc:

if &term =~ "xterm" || &term =~ "screen" || &term =~ "tmux"
  let &t_BE = "\e[?2004h"
  let &t_BD = "\e[?2004l"
  exec "set t_PS=\e[200~"
  exec "set t_PE=\e[201~"
endif

Neovim handles bracketed paste by default without configuration. With this enabled, Vim automatically disables formatting when you paste, eliminating the need to toggle manually.

Checking paste mode status

You can verify the current state:

:set paste?

Returns paste if enabled, nopaste if disabled.

Why this matters

Without paste mode, Vim interprets each keystroke as input, triggering indent rules character by character. This causes cascading indentation that mangles code structure. Paste mode treats the entire clipboard as raw input, bypassing all formatting logic.

Avoiding paste mode altogether

If you’re working with code regularly, consider these alternatives:

Most modern Vim configurations support bracketed paste automatically, so explicit paste mode toggling has become less critical. However, knowing how to control it remains essential for edge cases and when working on older systems.

Essential Editor Configuration

A well-configured editor dramatically improves productivity. For Vim users, invest time in crafting a solid vimrc. For Emacs users, use use-package for cleaner configuration management. Both editors support extensive plugin ecosystems that can transform them into full IDEs.

Learn the navigation commands thoroughly before adding plugins. Mastery of core movement commands (word, paragraph, search motions in Vim; mark, isearch, ace-jump in Emacs) provides more productivity gains than any single plugin.

Performance Tips

Large files can slow down both editors. For Vim, set lazyredraw and disable syntax highlighting for files over a certain size. For Emacs, use so-long-mode for files with long lines. Both editors benefit from disabling line numbers on very large files to improve scrolling performance.

Quick Verification

After applying the changes described above, verify that everything works as expected. Run the relevant commands to confirm the new configuration is active. Check system logs for any errors or warnings that might indicate problems. If something does not work as expected, review the steps carefully and consult the official documentation for your specific version.

← All posts