712

How can you switch your current windows from horizontal split to vertical split and vice versa in Vim?

I did that a moment ago by accident but I cannot find the key again.

2

9 Answers 9

1083

Vim mailing list says (re-formatted for better readability):

To change two vertically split windows to horizonally split

Ctrl-w t Ctrl-w K

Horizontally to vertically:

Ctrl-w t Ctrl-w H

Explanations:

Ctrl-w t makes the first (topleft) window current

Ctrl-w K moves the current window to full-width at the very top

Ctrl-w H moves the current window to full-height at far left

Note that the t is lowercase, and the K and H are uppercase.

Also, with only two windows, it seems like you can drop the Ctrl-w t part because if you're already in one of only two windows, what's the point of making it current?

8
  • 39
    So if you have two windows split horizontally, and you are in the lower window, you just use ^WL. Commented Aug 13, 2009 at 2:17
  • 9
    .... The power... My vim-fu doubled today, thank you. There are a ton of interesting ^w commands (b, w, etc)
    – Alex Hart
    Commented Dec 7, 2012 at 14:10
  • 4
    @Eno Works fine for me. Just toggle your NERDTree panel closed before 'rotating' the splits, then toggle it back open. :NERDTreeToggle (I have it mapped to a function key for convenience).
    – Lambart
    Commented Mar 26, 2014 at 19:34
  • 3
    I have added some leader mappings to my vim config: :nmap <leader>th <C-w>t<C-w>H and :nmap <leader>tk <C-w>t<C-w>K Commented Jun 8, 2016 at 18:13
  • 1
    In case anyone is wondering (like me) why K and H: Those are the Vim-Movements, you already know. Maybe I am the only stupid one here who didn't realized, but at least you know now :)
    – Bog
    Commented Jan 25, 2023 at 11:01
446

Ctrl-w followed by H, J, K or L (capital) will move the current window to the far left, bottom, top or right respectively like normal cursor navigation.

The lower case equivalents move focus instead of moving the window.

5
  • 7
    it's much better since users use hjkl to move between buffers. Commented Aug 22, 2014 at 6:07
  • 61
    The accepted answer is a good one, but for me, this answer is easier to remember. Thanks!
    – Jon Carter
    Commented Nov 23, 2015 at 22:14
  • Works better with nerdtree too.
    – arcseldon
    Commented Nov 7, 2017 at 16:04
  • It works for me on macOS by prefixing Ctrl-w (I don't know if ^ means Ctrl in your example). Commented Aug 9, 2018 at 21:52
  • @GiovanniBenussi yes, I think ^ means Ctrl.
    – ma11hew28
    Commented Sep 14, 2018 at 15:47
57

When you have two or more windows open horizontally or vertically and want to switch them all to the other orientation, you can use the following:

(switch to horizontal)

:windo wincmd K

(switch to vertical)

:windo wincmd H

It's effectively going to each window individually and using ^WK or ^WH.

0
36

The following ex commands will (re-)split any number of windows:

  • To split vertically (e.g. make vertical dividers between windows), type :vertical ball
  • To split horizontally, type :ball

If there are hidden buffers, issuing these commands will also make the hidden buffers visible.

4
  • This should be the accepted answer, as the current accepted answer will only work for two files. This answer is more complete. Commented Aug 13, 2015 at 17:53
  • :vert[ical] ball in the doc so :vert ball is also ok and shorter.
    – Titou
    Commented May 3, 2017 at 9:18
  • :ball reduces 3 vertical windows to 2 horizontal windows, while :vert ball correctly maps 3 horizontal windows to 3 vertical ones.
    – Titou
    Commented May 3, 2017 at 9:21
  • @DrStrangepork, it work on all open buffers instead of what is in split'ed windows. For eg: think that you are viewing 3 files in split'ed window out of 10 open buffers. Please see :ls for open buffers. Anyways, I like this answer along with other answers. +1 Commented Jul 20, 2020 at 18:53
30

Horizontal to vertical split

Ctrl+W for window command,

followed by Shift+H or Shift+L


Vertical to horizontal split

Ctrl+W for window command,

followed by Shift+K or Shift+J

Both solutions apply when only two windows exist.

After issuing the window command Ctrl+W, one is basically moving the window in the direction indicated by Shift+direction letter.


Opening help in a vertical split by default

Add both of these lines to .vimrc:

cabbrev help vert help
cabbrev h vert h

cabbrev stands for command abbreviation.

:vert[ical] {cmd} always executes the cmd in a vertically split window.

27

In VIM, take a look at the following to see different alternatives for what you might have done:

:help opening-window

For instance:

Ctrl-W s
Ctrl-W o
Ctrl-W v
Ctrl-W o
Ctrl-W s
...

0
8

Inspired by Steve answer, I wrote simple function that toggles between vertical and horizontal splits for all windows in current tab. You can bind it to mapping like in the last line below.

function! ToggleWindowHorizontalVerticalSplit()
  if !exists('t:splitType')
    let t:splitType = 'vertical'
  endif

  if t:splitType == 'vertical' " is vertical switch to horizontal
    windo wincmd K
    let t:splitType = 'horizontal'

  else " is horizontal switch to vertical
    windo wincmd H
    let t:splitType = 'vertical'
  endif
endfunction

nnoremap <silent> <leader>wt :call ToggleWindowHorizontalVerticalSplit()<cr>
1
  • Works even better for me if I force it to stay in the same split like so if winnr() == 1 windo wincmd J windo wincmd k else windo wincmd J endif and if winnr() == 1 windo wincmd L windo wincmd h else windo wincmd L endif Hope that make sense.
    – mjhoffmann
    Commented Jan 5, 2020 at 9:59
6

Following Mark Rushakoff's tip above, here is my mapping:

" vertical to horizontal ( | -> -- )
noremap <c-w>-  <c-w>t<c-w>K
" horizontal to vertical ( -- -> | )
noremap <c-w>\|  <c-w>t<c-w>H
noremap <c-w>\  <c-w>t<c-w>H
noremap <c-w>/  <c-w>t<c-w>H

Edit: use Ctrl-w r to swap two windows if they are not in the good order.

0

Coming across this in 2023, where both vim & neovim provides the built-in winlayout() function, which returns the structure of your windows as a tree. This can be parsed and manipulated in any way one wishes, and then reapplied to render the transformed layout, by doing something outlined in this Vi & Vim answer.

Motivated by this same use case, I also extracted from my own config a small plugin called ventana.nvim, which others might find convenient to use too.

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