nemanjamalesija/smart-paste.nvim

github

editing-support

62

2

0

0

CREATED

2026-02-07

UPDATED

2026-02-13

---

smart-paste.nvim

Pasted code automatically lands at the correct indentation level.

Features

• Intercepts p / P / gp / gP so linewise pasted code lands at the right indent level automatically.
• Adds ]p / [p to paste charwise content as a correctly indented new line below/above.
• Three-tier indent strategy: indentexpr -> treesitter scope analysis -> heuristic fallback.
• Visual mode (V + p/P): replace selected lines with correctly indented content.
• Dot-repeat (.) works naturally.
• Single undo step: one u undoes the entire paste.
• Register-safe behavior: registers are read, never rewritten.
• Zero dependencies: pure Lua, no external plugins required.
• Zero config: call setup() and paste keys are enhanced.

Installation

-- lazy.nvim
{
  'nemanjamalesija/smart-paste.nvim',
  event = 'VeryLazy',
  config = true,
}

-- packer.nvim
use {
  'nemanjamalesija/smart-paste.nvim',
  config = function()
    require('smart-paste').setup()
  end,
}

" vim-plug
Plug 'nemanjamalesija/smart-paste.nvim'
" then in your init.lua: require('smart-paste').setup()

Setup

require('smart-paste').setup()

Default mappings are enabled automatically:

• p, P, gp, gP
• ]p, [p

Optional setup:

require('smart-paste').setup({
  exclude_filetypes = {}, -- filetypes that skip smart indent
})

Indentation settings (shiftwidth, expandtab, tabstop) come from your buffer options. No plugin-specific indent config needed.

Remapping Keys

If you set keys, it replaces the defaults. Use this only when you want custom key behavior.

Flat string remap:

require('smart-paste').setup({
  keys = { 'p', 'P', ']p', '[p' },
})

Structured remap (custom behavior flags):

require('smart-paste').setup({
  keys = {
    'p',
    { lhs = '-p', after = true, follow = false, charwise_newline = true },
  },
})

Shorthand remap by inheriting behavior from a built-in key:

require('smart-paste').setup({
  keys = {
    'p',
    { lhs = '-p', like = ']p' }, -- behaves like ]p (charwise newline below)
  },
})

Mappings

Smart paste applies to linewise registers (for example: yy, dd, 2yy, or linewise Visual V + y). For charwise registers, ]p and [p convert inline content into smart-indented new lines. Characterwise paste on p/P/gp/gP and blockwise (<C-v>) paste use native Neovim behavior.

Example escape-hatch bindings:

vim.keymap.set('n', '<leader>p', '<Plug>(smart-paste-raw-p)')
vim.keymap.set('n', '<leader>P', '<Plug>(smart-paste-raw-P)')

License

MIT