git.iko.soy/helix
on ce99ecc help sign in
helix/book/src/keymap.md
155 lines 4.6 kB history raw
1# Keymap
3## Normal mode
5### Movement
7| Key | Description |
8|-----|-----------|
9| h, Left | move left |
10| j, Down | move down |
11| k, Up | move up |
12| l, Right | move right |
13| w | move next word start |
14| b | move previous word start |
15| e | move next word end |
16| t | find 'till next char |
17| f | find next char |
18| T | find 'till previous char |
19| F | find previous char |
20| Home | move to the start of the line |
21| End | move to the end of the line |
22| m | Jump to matching bracket |
23| PageUp | Move page up |
24| PageDown | Move page down |
25| ctrl-u | Move half page up |
26| ctrl-d | Move half page down |
27| ctrl-i | Jump forward on the jumplist TODO: conflicts tab |
28| ctrl-o | Jump backward on the jumplist |
29| v | Enter select (extend) mode |
30| g | Enter goto mode |
31| : | Enter command mode |
32| z | Enter view mode |
33| ctrl-w | Enter window mode |
34| space | Enter space mode |
35| K | Show documentation for the item under the cursor |
37### Changes
39| Key | Description |
40|-----|-----------|
41| r | replace (single character change) |
42| i | Insert before selection |
43| a | Insert after selection (append) |
44| I | Insert at the start of the line |
45| A | Insert at the end of the line |
46| o | Open new line below selection |
47| o | Open new line above selection |
48| u | Undo change |
49| U | Redo change |
50| y | Yank selection |
51| p | Paste after selection |
52| P | Paste before selection |
53| > | Indent selection |
54| < | Unindent selection |
55| = | Format selection |
56| d | Delete selection |
57| c | Change selection (delete and enter insert mode) |
59### Selection manipulation
61| Key | Description |
62|-----|-----------|
63| s | Select all regex matches inside selections |
64| S | Split selection into subselections on regex matches |
65| alt-s | Split selection on newlines |
66| ; | Collapse selection onto a single cursor |
67| alt-; | Flip selection cursor and anchor |
68| % | Select entire file |
69| x | Select current line |
70| X | Extend to next line |
71| [ | Expand selection to parent syntax node TODO: pick a key |
72| J | join lines inside selection |
73| K | keep selections matching the regex TODO: overlapped by hover help |
74| space | keep only the primary selection TODO: overlapped by space mode |
75| ctrl-c | Comment/uncomment the selections |
77### Search
79> TODO: The search implementation isn't ideal yet -- we don't support searching
80in reverse, or searching via smartcase.
82| Key | Description |
83|-----|-----------|
84| / | Search for regex pattern |
85| n | Select next search match |
86| N | Add next search match to selection |
87| * | Use current selection as the search pattern |
89## Select / extend mode
91I'm still pondering whether to keep this mode or not. It changes movement
92commands to extend the existing selection instead of replacing it.
94> NOTE: It's a bit confusing at the moment because extend hasn't been
95> implemented for all movement commands yet.
97## View mode
99View mode is intended for scrolling and manipulating the view without changing
100the selection.
102| Key | Description |
103|-----|-----------|
104| z , c | Vertically center the line |
105| t | Align the line to the top of the screen |
106| b | Align the line to the bottom of the screen |
107| m | Align the line to the middle of the screen (horizontally) |
108| j | Scroll the view downwards |
109| k | Scroll the view upwards |
111## Goto mode
113Jumps to various locations.
115> NOTE: Some of these features are only available with the LSP present.
117| Key | Description |
118|-----|-----------|
119| g | Go to the start of the file |
120| e | Go to the end of the file |
121| h | Go to the start of the line |
122| l | Go to the end of the line |
123| t | Go to the top of the screen |
124| m | Go to the middle of the screen |
125| b | Go to the bottom of the screen |
126| d | Go to definition |
127| y | Go to type definition |
128| r | Go to references |
129| i | Go to implementation |
131## Object mode
133TODO: Mappings for selecting syntax nodes (a superset of `[`).
135## Window mode
137This layer is similar to vim keybindings as kakoune does not support window.
139| Key | Description |
140|-----|-------------|
141| w, ctrl-w | Switch to next window |
142| v, ctrl-v | Vertical right split |
143| h, ctrl-h | Horizontal bottom split |
144| q, ctrl-q | Close current window |
146## Space mode
148This layer is a kludge of mappings I had under leader key in neovim.
150| Key | Description |
151|-----|-----------|
152| f | Open file picker |
153| b | Open buffer picker |
154| w | Save changes to file |
155| space | Keep primary selection TODO: it's here because space mode replaced it |