Keymaps Reference

Complete keybinding reference for BabaVim, organised by functionality.

Leader Keys

• Primary Leader: <Space>
• Local Leader: \ (document-specific commands)

Navigation

Window Navigation

<C-h>           " Move to left window
<C-j>           " Move to bottom window
<C-k>           " Move to top window
<C-l>           " Move to right window

Window Resizing

<S-Up>          " Decrease window height
<S-Down>        " Increase window height
<S-Left>        " Decrease window width
<S-Right>       " Increase window width

<Leader>Wk      " Decrease window height (universal)
<Leader>Wj      " Increase window height (universal)
<Leader>Wh      " Decrease window width (universal)
<Leader>Wl      " Increase window width (universal)

Buffer Navigation

<S-h>           " Previous buffer
<S-l>           " Next buffer

<Leader>Bb      " Previous buffer (BufferLine)
<Leader>Bn      " Next buffer (BufferLine)
<Leader>Bp      " Pick buffer (BufferLine)
<Leader>Bf      " Find buffers (Telescope)
<Leader>Bl      " List all buffers (including unlisted)
<Leader>Bq      " Close buffer

File Navigation

<Leader>f       " Find files (Telescope)
<Leader>F       " Find files by frequency/recency (Telescope frecency)
<Leader>Ff      " Find files (frecency)
<Leader>Fr      " Refresh frecency database
<Leader>Fd      " Show frecency database location
<Leader>Fb      " Rebuild frecency database
<Leader>e       " Toggle file explorer (NvimTree)

LSP Operations

Core LSP

gd              " Go to definition
gD              " Go to declaration
K               " Show hover documentation
<Leader>Lf      " Format document
<Leader>LR      " Show references
<Leader>Lr      " Restart LSP
<Leader>Ll      " List active LSP servers
<Leader>Lm      " Open Mason

Mason Package Management

Enhanced Mason Operations

<Leader>MA      " Install academic LSP servers
<Leader>MR      " Install all recommended servers
<Leader>MU      " Update all packages
<Leader>MS      " Show Mason status
<Leader>Mm      " Open Mason interface
<Leader>Mi      " Install package
<Leader>Mu      " Uninstall package
<Leader>Ml      " View Mason log
<Leader>Mh      " Mason help

Document Processing

LaTeX/VimTeX

VimTeX provides comprehensive default keymaps (see :help vimtex-default-mappings):

\LocalLeader\ll  " Compile LaTeX (standard)
\LocalLeader\lb  " Compile with LuaLaTeX+Biber (latexmk → biber → latexmk × 2)
\LocalLeader\lv  " View PDF (forward search)
\LocalLeader\lk  " Stop compilation
\LocalLeader\lK  " Stop all compilations
\LocalLeader\lc  " Clean auxiliary files
\LocalLeader\lC  " Clean all files (including PDF)
\LocalLeader\lt  " Open table of contents
\LocalLeader\lT  " Toggle table of contents
\LocalLeader\le  " Show errors
\LocalLeader\lo  " Show compilation output
\LocalLeader\lg  " Show status
\LocalLeader\lG  " Show status (all)
\LocalLeader\lq  " Show log
\LocalLeader\li  " Show info
\LocalLeader\lI  " Show info (full)
\LocalLeader\lx  " Reload VimTeX
\LocalLeader\lX  " Reload VimTeX state
\LocalLeader\la  " Context menu
\LocalLeader\lm  " List insert mode maps
" And many more - see :help vimtex-default-mappings

Note: The custom LuaLaTeX+Biber compilation (\lb) opens a terminal window in normal mode, allowing you to scroll through output, yank error messages, and dismiss with q when done.

Typst

\LocalLeader\tp " Toggle Typst preview
\LocalLeader\ts " Sync cursor in preview
\LocalLeader\tc " Compile PDF
\LocalLeader\tw " Watch file

Markdown/Quarto

<Leader>Kp      " Start markdown preview
<Leader>Ks      " Stop markdown preview
<Leader>Kv      " Toggle markdown preview

<Leader>Kln     " Autolist: Next list style
<Leader>Klp     " Autolist: Previous list style

<Leader>Qp      " Quarto preview
<Leader>Qc      " Close Quarto preview
<Leader>QRh     " Render to HTML
<Leader>QRp     " Render to PDF
<Leader>QRw     " Render to Word

Markdown Table Operations

Table editing operations for markdown and quarto files (table-nvim):

<Leader>Ktf     " Format/realign table
<Leader>Ktn     " Next cell
<Leader>Ktp     " Previous cell
<Leader>Kto     " Insert row below
<Leader>KtO     " Insert row above
<Leader>KtJ     " Move row down
<Leader>KtK     " Move row up
<Leader>Kti     " Insert column right
<Leader>KtI     " Insert column left
<Leader>KtL     " Move column right
<Leader>KtH     " Move column left
<Leader>Ktdc    " Delete column
<Leader>Ktt     " Insert table
<Leader>KtT     " Insert table (no outline)

Note: Table operations live under <Leader>Kt…. Markdown preview is <Leader>Kp (start), <Leader>Ks (stop), <Leader>Kv (toggle).

Molten (Jupyter)

<Leader>QMi     " Show image popup
<Leader>QMl     " Evaluate line
<Leader>QMe     " Evaluate operator
<Leader>QMn     " Initialize kernel
<Leader>QMk     " Stop kernel
<Leader>QMr     " Restart kernel
<Leader>QMv     " Evaluate visual selection
<Leader>QMf     " Re-evaluate cell
<Leader>QMh     " Hide output
<Leader>QMs     " Show output
<Leader>QMd     " Delete cell
<Leader>QMb     " Open in browser

Academic Workflow

Julia Development

<Leader>Jrh     " Horizontal Julia REPL
<Leader>Jrv     " Vertical Julia REPL
<Leader>Jrf     " Floating Julia REPL
<Leader>Jp      " Project status
<Leader>Ji      " Instantiate project
<Leader>Ju      " Update project
<Leader>Jt      " Run tests
<Leader>Jd      " Generate documentation

Obsidian Integration

<Leader>On      " New Obsidian note
<Leader>Ol      " Insert Obsidian link
<Leader>Of      " Follow Obsidian link
<Leader>Oc      " Toggle Obsidian checkbox
<Leader>Ob      " Show Obsidian backlinks
<Leader>Og      " Show Obsidian outgoing links
<Leader>Oo      " Find files in Obsidian vault
<Leader>Ot      " Insert Obsidian template
<Leader>ON      " New note from template
<Leader>Op      " Paste image into note
<Leader>Ov      " Toggle Obsidian preview

Terminal Integration

Terminal Management

<C-t>           " Toggle terminal
<Leader>Tt      " Toggle terminal (vertical default)
<Leader>Th      " Horizontal terminal (15 lines)
<Leader>Tv      " Vertical terminal (30%)
<Leader>Tf      " Floating terminal
<Leader>Tk      " Clear terminal
<Leader>Td      " Kill terminal

<A-1>           " Horizontal terminal (15 lines)
<A-2>           " Vertical terminal (30%)
<A-3>           " Floating terminal

Terminal Code Execution

<C-i>           " Send current line to terminal
<C-c>           " Send current code block to terminal
<C-s>           " Send visual selection to terminal

Git Operations

<Leader>Gs      " Git status
<Leader>Gp      " Git pull
<Leader>Gg      " LazyGit interface

Search Operations

<Leader>g       " Grep in project (direct command)
<Leader>Sp      " Search in project
<Leader>Sw      " Search in working directory
<Leader>Sh      " Search in home directory
<Leader>Sc      " Search in config
<Leader>Sf      " Search in current file directory

Configuration Management

<Leader>Cs      " Reload configuration
<Leader>Cf      " Find config files
<Leader>Cg      " Grep in config files

Theme & Appearance

Theme Management

<Leader>Yc      " Cycle through themes
<Leader>Yw      " Toggle word wrap
<Leader>Yz      " Toggle Zen Mode (markdown writing)
<Leader>Yn      " Toggle line numbers
<Leader>Ys      " Toggle spell check
<Leader>Yse     " Set spell language to English (British)
<Leader>Ysf     " Set spell language to French
<Leader>z       " Toggle Zen Mode (quick shortcut)

Window Management

Split Operations

<Leader>|v      " Vertical split
<Leader>|h      " Horizontal split

Diagnostics

<Leader>Xw      " Workspace diagnostics
<Leader>Xd      " Document diagnostics
<Leader>Xl      " Location list
<Leader>Xq      " Quickfix
<Leader>Xx      " Toggle Trouble

Plugin Management

<Leader>CUa     " Update all plugins
<Leader>CUs     " Show plugin status
<Leader>CUc     " Cleanup orphaned plugins

Editor Basics

<Leader>w       " Write file
<C-s>           " Quick save
<Leader>q       " Close buffer
<Esc>           " Clear search highlights
<Leader>h       " Clear search highlights (alternative)

" Better indenting (visual mode)
<               " Indent left
>               " Indent right

" Move text (visual mode)
J               " Move selection down
K               " Move selection up

" Better paste (visual mode)
p               " Paste without yanking

Search & Replace

" Clear search highlights
<Esc>           " Clear highlights
<Leader>h       " Clear highlights (alternative)

" Incremental search
/               " Forward search
?               " Backward search
*               " Search word under cursor
#               " Search word under cursor (backward)
n               " Next match
N               " Previous match

Quick Access

<Leader>q       " Close buffer (quick access)

Special Characters

Which-Key Triggers

• <Space> - Show all leader key groups
• <LocalLeader> - Show local leader commands
• <C- - Control key combinations
• <A- - Alt key combinations
• <S- - Shift key combinations

Customization

Adding Keymaps

Create ~/.config/nvim/lua/user.lua:

-- Add your custom keymaps
vim.keymap.set("n", "<leader>mykey", ":MyCommand<CR>", {
    desc = "My custom command"
})

Remapping Existing Keys

-- Remap existing keymap
vim.keymap.set("n", "<leader>f", ":MyCustomFinder<CR>", {
    desc = "Custom file finder"
})

Keymap Discovery

Which-Key Integration

• Press <Space> and wait to see all available commands
• Type part of a command to filter results
• Use <BS> to go back in the navigation tree

Help Commands

:WhichKey        " Show all keymaps
:WhichKey <key>  " Show keymaps for specific key
:help which-key  " Which-Key documentation

Troubleshooting

Keymap Conflicts

1. Check for conflicting mappings: :verbose map <key>
2. Use :WhichKey to visualize conflicts
3. Override in user.lua if needed

Slow Keymaps

1. Check for expensive operations in keymap functions
2. Use vim.defer_fn() for heavy operations
3. Consider lazy loading heavy plugins

Missing Keymaps

1. Ensure plugin is loaded: :lua require("plugins.plugin-name")
2. Check plugin configuration
3. Verify keymap registration in plugin files

---

Press <Space> to view available keymaps via Which-Key.