119

I tried to map <Alt+D> to <Ctrl+D> by adding the below line to .vimrc, but it doesn't work. I checked the .vimrc is loaded by Vim.

map <Alt-D> <C-D>

Is there any error in this mapping?

4
  • Are you using vim in a terminal, or a gui version (gvim, macvim)? Commented Sep 28, 2011 at 18:52
  • Also note that if your encoding changes after the mapping runs, what you get out of your Alt keys may not match what you initially set. Commented Feb 15, 2016 at 23:35
  • In insert mode, press control+v, then your key combo alt+d & it should insert ^[d. So you end up with map ^[d <C-D> or what have you. Note that TYPING ^[d does not do the same thing.
    – Reed
    Commented Feb 5, 2021 at 16:56
  • Your Operating system or Terminal Emulator (or maybe both) has intercepted your Alt-d keystroke and performed an action that produced no visible change (New-Bookmark?). Find your OS system settings->keymaps tool and remove all keymaps associated with Alt-d. Again do this with keybindings defined in your Terminal settings->keymaps. Now vim is able to receive your Alt-d. Commented Jun 5, 2022 at 1:47

11 Answers 11

179

To Mac users out there: for mapping ALT+hjkl, use instead the real character generated (find out which character using the combination while in INSERT mode), for example with my keyboard I get:

<ALT+j> ==> ª
<ALT+k> ==> º

and so on. Solution found here on StackOverflow.

I used this to move lines up and down with ALT+k\j, using this on my .vimrc:

nnoremap ª :m .+1<CR>==
nnoremap º :m .-2<CR>==

inoremap ª <Esc>:m .+1<CR>==gi
inoremap º <Esc>:m .-2<CR>==gi

vnoremap ª :m '>+1<CR>gv=gv
vnoremap º :m '<-2<CR>gv=gv

as explained here.

Hope it's useful, enjoy Vim :)

ADDENDUM BY Dylan_Larkin (2019): For this to work on a Mac, "Use Option as Meta Key" must be turned OFF in Terminal->Preferences->Keyboard

UPDATE 09/2021

I recently switched from a "British" keyboard to "ABC - Extended" and noticed this configuration doesn't work as expected. As an alternative, I mapped the <up> and <down> keys to do the same operation (which, I guess, also solves most of the complexity explained in other answers of this very question):

nnoremap <down> :m .+1<CR>==
nnoremap <up> :m .-2<CR>==

inoremap <down> <Esc>:m .+1<CR>==gi
inoremap <up> <Esc>:m .-2<CR>==gi

vnoremap <down> :m '>+1<CR>gv=gv
vnoremap <up> :m '<-2<CR>gv=gv

This is also a great way for beginners to rewire the habit of using the arrows and instead learn the much more efficient Vim motion way to move around the code. ;)

You can complete your transition mapping <left> and <right> to quickly move between tabs with:

nnoremap <left> gT
nnoremap <right> gt

Or whatever you fancy (even a brutal <NOP>, like I did at the beginning of my journey).

21
  • 13
    This is just what I came here for (Alt+HJKL to move splits)! Thanks! Commented Jun 14, 2013 at 13:17
  • 6
    A easy way to find out which character it is, is by using cat. Simply type cat and inside the cat window the key combination you want. Found out that alt + brackets is ‘ and “ on my mac.
    – patchrail
    Commented Jul 22, 2014 at 21:25
  • 4
    this works great as Alt+HJKL to move between splits, my fingers love it!! nmap ˙ <C-w><Left> nmap ¬ <C-w><Right> nmap ˚ <C-w><Up> nmap ∆ <C-w><Down> Commented Dec 10, 2014 at 1:54
  • 4
    These exact mappings may not work as expected in future versions of OSX. Use sed -n l to see the output of <A-k> and <A-j> before you configure the mapping. In my case <A-j> is and <A-k> is ˚
    – luk3thomas
    Commented Jan 13, 2016 at 14:31
  • 6
    On macOS, when setting Use Option as Meta Key or on iTerm profile ⌥ key to Esc+ will behave as the traditionally way (like on Linux/Unix). So you don't need to set on Vim the map to <^[j>, just map it to <A+j> or <M+j> and it works.
    – goetz
    Commented Feb 2, 2019 at 19:07
62

:help key-notation describes what format needs to be used to map different keys. In the case of alt, you can use either <A- or <M-. So your mapping would be

map <M-d> <C-d>

I'd also recommend using the nore variant of :map (e.g., noremap) unless you explicitly want to allow the right-hand side to be re-evaluated for mappings.

5
  • 2
    This still doesn't have any effect. Alt+D input still inputs some strange character to Vim.
    – Thomson
    Commented Sep 21, 2011 at 14:16
  • 13
    That's a separate issue. Your terminal is sending a multi-byte character to Vim and Vim doesn't know to interpret that as <A-d>. You probably need to change your terminal's settings so it sends <A-d> as <Esc>d.
    – jamessan
    Commented Sep 21, 2011 at 14:19
  • 3
    @jamessan how to do it on iterm2?
    – Finn
    Commented Nov 9, 2018 at 4:22
  • @jamessan Thanks. this key notation <A-j> works well in idea vim on Mac.
    – Richard
    Commented Aug 15, 2023 at 7:37
  • Works in 2023 on neovim and NixOS 23.05
    – Zaar Hai
    Commented Oct 23, 2023 at 14:44
46

I'm not sure is "possible" anymore. Please read the update below.

Yes, you can even in terminal vim, but there's no real catch all answer. You basically have to follow two steps:

  1. Make sure the <M-d> notation exists, and map exactly what your terminal inputs (^[ is the escape character):

    $ cat
    ^[d
    $
    
    " in your .vimrc
    execute "set <M-d>=\ed"
    " you have to use double quotes!
    
  2. Map something to your newly "created" combination:

    noremap <M-d> :echo "m-d works!"<cr>
    

Understanding how it works, you can expand this "trick" to other "strange" combinations, for instance, I'm using termite, and vim doesn't recognize <S-F1>, using cat I get ^[[1;2P. Then, in my vimrc I do: execute "set <S-F1>=\e[1;2P", and then I can map it to anything.

Note: I don't know why, but for some people using \<Esc> works instead of \e.


Update (february 2016)

Depending on the terminfo your terminal runs, maybe you could... in most terminals, "alt + h", for example, is mapped to ^[h, which is: "escape + h". So it could overwrite keys. I've just tried (again) and it seems to work, but I believe it's a very buggy and error prone implementation.

Nevertheless, for the brave enough, here's an experimental plugin:

4
  • 2
    Instead of the execute "set... stuff, you can just directly use set <M-d>=^[d. The ^[ is actually an escape character entered with C-v-Esc. This was necessary in rxvt/urxvt, but xterm shouldn’t need the special treatment. More info on this topic in the vim wiki. Commented Aug 20, 2015 at 18:48
  • Is there an analogous approach to this that would work with tmux so that i.e., M-d could be binded?
    – George
    Commented Feb 11, 2016 at 16:08
  • 3
    For me, <Esc> then d now does the same thing as <Alt>+d. Also, you can just do this in one line with Ctrl-v, <Esc> as per here.
    – Sparhawk
    Commented Jan 18, 2017 at 4:58
  • I've had issues with vim-move [1], but this finally fixed it -- thanks!! [1] github.com/matze/vim-move/issues/15 Commented Jan 20, 2021 at 17:29
30

Map Alt Key in Vim on Mac OSx:

Start by viewing the key code your terminal is sending to vim:

$ sed -n l
^[[1;9D 

In the above example, I ran the command and pressed Alt + Left.

The ^[[1;9D is the escaped sequence being sent to vim, so we can user that for our mapping.

map <Esc>[1;9D 
3
  • 4
    If you are using iTerm2 app, it is good to check how the keys are mapped in the Profile > Keys.
    – fikovnik
    Commented Feb 13, 2017 at 1:12
  • 1
    With left Option key () configured as Esc+ in iTerm2, I could map alt+q to quit vim: nnoremap <silent> <Esc>q :qa!<cr>
    – ryenus
    Commented Nov 21, 2018 at 3:18
  • You can also setup iTerm2 to work with that remap if you go to Preferences > Profiles, select your current profile, go to the "keys" tab for that profile and change the option that says "Left ⌥ Key" to "Esc+" (available options are "Normal", "Meta", and "Esc+"). Commented Apr 4, 2019 at 11:54
17

Use:

map <A-D> <C-D>

See :help key-notation.

3
  • 1
    It seems this still doesn't work. Alt+d will input an strange character to Vim, which is the same with the unmap case.
    – Thomson
    Commented Sep 21, 2011 at 14:12
  • Works for me (I'm using gvim on Windows)
    – Deqing
    Commented Sep 2, 2013 at 7:29
  • @Thomson Your terminal/konsole GUI has intercepted your Alt-d and relayed a different keystroke that can be found by going to terminal->settings->keymaps. Your vim command is working perfectly, it's the keystroke that isn't getting past your terminal window. Commented Jun 4, 2022 at 5:26
11

My Terminal would produce ^[x commands (e.g. for alt-x). What got it to work inside Vim was this small script from vim.wikia.com:

for i in range(97,122)
  let c = nr2char(i)
  exec "map \e".c." <M-".c.">"
  exec "map! \e".c." <M-".c.">"
endfor

Add to .vimrc to fix all alt key mappings.

0
10

as a follow up to Bruno's answer for Mac users, try making sure your option key is mapped to Esc+.

This will give you the "normal" behavior of the option (A) key in Vim.

For example, in iterm2, this option can be found under Preferences > Profiles > Keys:

iterm2 preferences screenshot

1
  • I also had to change the config to nnoremap <Esc>j :m .+1<CR>== and similar... Commented Jun 23, 2020 at 19:24
9

Your terminal might not transmit "properly" the Alt-D. You can use C-V to actually get the actual escape sequence send to Vim and use it to create your mapping. Ie, edit your .vimrc and replace the actual by typing the following sequence "C-V Alt-D" so you'll have the correct escape sequence in your vimrc. That won't work if your terminal doesn't send anything to vim.

3

Find out key mapping by putting following command in your vim editor

:help key-notation

It will display all the key mapping.

enter image description here

In my ubuntu system for Alt it is <M-...>. It is possible for your version mapping might be different. If you too have same mapping then following should work.

map <M-D> <C-D>
1

Hello after no good solution after years of testing all the above on mac, I kept searching.

Here is my solution:

To create a combination keystroke including Alt you have to declare the combination in the preference > keyboard and use that combination in the vim setup file (check use option as meta key).

The output must be an unusual character (no a for example) so that you're not overriding a regular character.

In the example below you should be able to quite vim with ALT-Up.

vim setting: vim setting

mac setting: mac setting

0

Another good option in 2024 for MacOS is to first disable international character support for the Option key; if that is acceptable, you can check out the solution here How to disable generating special characters when pressing the `alt+a`/`option+a` keybinding in Mac OS (`⌥+a` )?

Once that is done, set your terminal (e.g. iTerm2) to Esc+. Now the shortcuts will work.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

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