Skip to content

⌨️ Mappings

AstroNvim generally relies on <Leader> driven mappings, which is default set to <Space>. For information on what the <Leader>, check out the :h mapleader. which-key.nvim is also used to provide help for discovering and remembering these mappings. Simply press a key like <Space> and a help menu will pop up with labelled menus and options.

General Mappings

ActionMappings
Leader keySpace
Local Leader key,
Resize upCtrl + Up
Resize DownCtrl + Down
Resize LeftCtrl + Left
Resize RightCtrl + Right
Up WindowCtrl + k
Down WindowCtrl + j
Left WindowCtrl + h
Right WindowCtrl + l
Force WriteCtrl + s
Force QuitCtrl + q
New FileLeader + n
Close BufferLeader + c
Next Tab (real vim tab)]t
Previous Tab (real vim tab)[t
CommentLeader + /
Horizontal Split\
Vertical Split|

Buffers

ActionMappings
Next Buffer]b
Previous Buffer[b
Move Buffer Right>b
Move Buffer Left<b
Navigate to buffer tab with interactive pickerLeader + bb
Close all buffers except the currentLeader + bc
Close all buffersLeader + bC
Delete a buffer tab with interactive pickerLeader + bd
Close all buffers to the left of the currentLeader + bl
Go to the previous bufferLeader + bp
Close all buffers to the right of the currentLeader + br
Sort buffers by extensionLeader + bse
Sort buffers by buffer numberLeader + bsi
Sort buffers by last modificationLeader + bsm
Sort buffers by full pathLeader + bsp
Sort buffers by relative pathLeader + bsr
Open a buffer tab in a new horizontal split with interactive pickerLeader + b\
Open a buffer tab in a new vertical split with interactive pickerLeader + b|

List Management

ActionMappings
Open Quickfix ListLeader + xq
Next Quickfix Entry]q
Previous Quickfix Entry[q
Last Quickfix Entry]Q
First Quickfix Entry[Q
Open Local ListLeader + xl
Next Local List Entry]l
Previous Local List Entry[l
Last Local List Entry]L
First Local List Entry[L

Better Escape

ActionMappings
Escape keyjj, jk

Completion

ActionMappings
Open completion menuCtrl + Space
Select completionEnter
Next snippet locationTab
Previous snippet locationShift + Tab
Next completionDown, Ctrl + n, Ctrl + j, Tab
Previous completionUp, Ctrl + p, Ctrl + k, Shift + Tab
Cancel completionCtrl + e
Scroll up completion docsCtrl + u
Scroll down completion docsCtrl + d

Neo-Tree

ActionMappings
Neotree toggleLeader + e
Neotree focusLeader + o

Dashboard Mappings

ActionMappings
Dashboard (Home)Leader + h

Session Manager Mappings

ActionMappings
Save SessionLeader + Ss
Last SessionLeader + Sl
Delete SessionLeader + Sd
Delete Directory SessionLeader + SD
Search SessionsLeader + Sf
Search Directory SessionsLeader + SF
Load Current Directory SessionLeader + S.

Package Management Mappings

ActionMappings
Update Lazy and MasonLeader + pa
Plugins InstallLeader + pi
Mason InstallerLeader + pm
Mason UpdaterLeader + pM
Plugins StatusLeader + ps
Plugins SyncLeader + pS
Plugins Check for UpdatesLeader + pu
Plugins UpdateLeader + pU

LSP Mappings

ActionMappings
LSP InfoLeader + li
None-ls InfoLeader + lI
Hover DocumentK
Format DocumentLeader + lf
Symbols OutlineLeader + lS
Line Diagnosticsgl, Leader + ld, <C-W> + d
All DiagnosticsLeader + lD
Code Actionsgra, Leader + la
Source Code ActionsLeader + lA
Signature HelpLeader + lh
Renamegrn, Leader + lr
Document SymbolsLeader + ls
Workspace SymbolsLeader + lG
Diagnostic Next]d
Diagnostics Previous[d
Diagnostic Error Next]e
Diagnostic Error Previous[e
Diagnostic Warning Next]w
Diagnostic Warning Previous[w
Document Symbol Next]y
Document Symbol Previous[y
DeclarationgD
Type Definitiongy
Definitiongd
ImplementationgI
Referencesgrr, Leader + lR

Debugger Mappings

ActionMappings
Start/Continue DebuggerLeader + dc or <F5>
Pause DebuggerLeader + dp or <F6>
Restart DebuggerLeader + dr or <C-F5>
Run Debugger to CursorLeader + ds
Close Debugger SessionLeader + dq
Terminate DebuggerLeader + dQ or <S-F5>
Toggle BreakpointLeader + db or <F9>
Conditional BreakpointLeader + dC or <S-F9>
Clear BreakpointsLeader + dB
Step OverLeader + do or <F10>
Step IntoLeader + di or <F11>
Step OutLeader + dO or <S-F11>
Evaluate ExpressionLeader + dE
Toggle REPLLeader + dR
Toggle Debugger UILeader + du
Debugger HoverLeader + dh

Telescope Mappings

ActionMappings
Resume previous searchLeader + f + Enter
MarksLeader + f'
BuffersLeader + fb
Word at cursorLeader + fc
CommandsLeader + fC
Find filesLeader + ff
Find files (include hidden files)Leader + fF
Help TagsLeader + fh
KeymapsLeader + fk
Man PagesLeader + fm
NotificationsLeader + fn
Old FilesLeader + fo
RegistersLeader + fr
ColorschemesLeader + ft
Live GrepLeader + fw
Live Grep (include hidden files)Leader + fW
Git BranchesLeader + gb
Git Commits (repository)Leader + gc
Git Commits (current file)Leader + gC
Git StatusLeader + gt
LSP SymbolsLeader + ls
LSP Workspace SymbolsLeader + lG

Terminal Mappings

ActionMappings
Open Floating TerminalLeader + tf
Open Horizontal TerminalLeader + th or <F7>
Open Vertical TerminalLeader + tv
Open Toggle LazygitLeader + tl
Open Toggle nodeLeader + tn
Open Toggle PythonLeader + tp
Open Toggle btmLeader + tt

UI/UX Mappings

ActionMappings
Toggle autopairsLeader + ua
Toggle automatic root detectionLeader + uA
Toggle backgroundLeader + ub
Toggle autocompletion (buffer)Leader + uc
Toggle autocompletion (global)Leader + uC
Toggle diagnosticsLeader + ud
Dismiss notificationsLeader + uD
Toggle autoformatting (buffer)Leader + uf
Toggle autoformatting (global)Leader + uF
Toggle signcolumnLeader + ug
Toggle foldcolumnLeader + u>
Toggle LSP inlay hints (buffer)Leader + uh
Toggle LSP inlay hints (global)Leader + uH
Toggle indent settingLeader + ui
Toggle indent guidesLeader + u|
Toggle statuslineLeader + ul
Toggle CodeLensLeader + uL
Change line numberingLeader + un
Toggle notificationsLeader + uN
Toggle paste modeLeader + up
Toggle reference highlighting (buffer)Leader + ur
Toggle reference highlighting (global)Leader + uR
Toggle spellcheckLeader + us
Toggle concealLeader + uS
Toggle tablineLeader + ut
Toggle URL highlightingLeader + uu
Toggle wrapLeader + uw
Toggle syntax highlighting (buffer)Leader + uy
Toggle LSP semantic tokens (buffer)Leader + uY
Toggle color highlightingLeader + uz