Show HN: VimFreeDrag – Move Blocks of Text in Vim

This plugin enables the movement of rectangular blocks of text, selected
using Vim’s visual block mode.
It was inspired by running this this issue
with a similar plugin vim-schlepp,
which was an adaptation of DragVisuals.vim.

Movement Model

When a block of text moves in a particular direction, there is quite likely to
be a pre-existing row or column of text that is now covered by the text being
moved. This plugin moves text by displacement: Pre-existing text in the
direction of movement is used to fill the space that is left behind by the
moved text. Where there is no pre-existing text and the movement direction is
Right or Down, the plugin assumes whitespace. For example, consider the
following block of text. Suppose we selection the rectangular block 4710..


Moving this block Up will move the line above it down to fill the gaps in the
row that was left behind on the bottom.


Moving this block Down creates a new line and then moves the whitespace from
the newline into the row that was left behind on the top.

5  8

Moving this block Left:


Moving this block Right:



Simply clone this plugin into the plugin directory that is read by Vim8.

pushd  ~/.vim/pack/plugins/start
git clone

To actually use it, create mappings in your ~/.vimrc for each direction of

vmap <unique> K  <Plug>FreeDragUp
vmap <unique> J  <Plug>FreeDragDown
vmap <unique> H  <Plug>FreeDragLeft
vmap <unique> L  <Plug>FreeDragRight

Please create issues if you find scenarios where it does not work as expected
that are not described in the limitations section.


While creating ASCII art for architecture diagrams, I realized that I needed to
be able to drag entire blocks around relatively independently of surrounding
text. I remembered listening to a
talk by Damian Conway where he
discussed a plugin called DragVisuals.vim. Searching around the web found
various versions that were rather buggy. Eventually, I found
vim-schlepp, which seemed to be the
spiritual sucessor to DragVisuals.vim. Unfortunately, that plugin behaved one
way when moving text up and down, and a different way when moving text left and
right. This clashed with my mental model for how dragging text should work;
hence the creation of this plugin.


  • Works only with in Visual Block mode. It will detect and reject other visual
  • This plugin has undefined behavior when the selection is non-rectangular;
    this can happen when using the $ command in visual block mode.

Products You May Like

Articles You May Like

Sunday’s Best Deals: Bike Tools, Menswear, USB-C Chargers, Kindle Books, and More
Revolut doesn’t care about you
Use United’s ‘Excursionist Perk’ to Get a Free One-Way Flight When Using Miles
Software Development as a Humanity
New York Landlords in a Financial Bind from New Rent Law

Leave a Reply

Your email address will not be published. Required fields are marked *