Rafael Bodill's Neovim Config

Lean mean Neovim machine, 30-45ms startup time. Works best with Neovim ≥0.10

⚙️ See "Extending" for customizing configuration and adding plugins.

🚩 git tag vim tracks the last revision using Dein.nvim and plugins.yaml. Since then, the entire configuration has been rewritten to use lazy.nvim and Lua.

I encourage you to fork this repo and create your own experience. Learn how to tweak and change Neovim to the way YOU like it. This is my cultivation of years of tweaking, use it as a git remote and stay in-touch with upstream for reference or cherry-picking.

Table of Contents (🔎 Click to expand/collapse)

• Features
• Screenshot
• Prerequisites
• Install
• Install LSP, DAP, Linters, Formatters
  • Language-Server Protocol (LSP)
  • Recommended LSP
  • Recommended Linters
  • Recommended Formatters
• Recommended Fonts
• Upgrade
• Structure
• Extending
  • Extend: Config
  • Extend: Plugins
  • Extend: Defaults
  • Extend: LSP Settings
• Plugin Highlights
• Plugins Included
  • Completion & Code-Analysis
  • Editor Plugins
  • Coding Plugins
  • Colorscheme Plugins
  • Git Plugins
  • Misc Plugins
  • Treesitter & Syntax
  • UI Plugins
• Extra Plugins
  • Extra Plugins: Coding
  • Extra Plugins: Colorscheme
  • Extra Plugins: Editor
  • Extra Plugins: Git
  • Extra Plugins: Lang
  • Extra Plugins: LSP
  • Extra Plugins: Org
  • Extra Plugins: Treesitter
  • Extra Plugins: UI
  • LazyVim Extras
    • Language
    • DAP (Debugging)
    • Test
• Custom Key-mappings
  • Navigation
  • Selection
  • Jump To
  • Buffers
  • Clipboard
  • Auto-Completion
  • LSP
  • Diagnostics
  • Coding
  • Search, Substitute, Diff
  • Command & History
  • File Operations
  • Editor UI
  • Window Management
  • Plugins
    • Plugin: Mini.Surround
    • Plugin: Gitsigns
    • Plugin: Diffview
    • Plugin: Telescope
    • Plugin: Neo-Tree
    • Plugin: Spectre
    • Plugin: Marks
    • Plugin: Zk

Features

• Fast startup time — plugins are almost entirely lazy-loaded!
• Robust, yet light-weight
• Plugin management with folke/lazy.nvim. Use with :Lazy or Space+l
• Install LSP, DAP, linters, and formatters. Use with :Mason or Space+mm
• LSP configuration with nvim-lspconfig
• telescope.nvim centric work-flow with lists (try ;+f…)
• Custom context-menu (try it! ;+c)
• Auto-complete extensive setup with nvim-cmp (try Tab or Ctrl+Space in insert-mode)
• Structure view with [hedyhli/outline.nvim]
• Git features using lewis6991/gitsigns.nvim, sindrets/diffview.nvim, and more
• Session management with folke/persistence.nvim
• Unobtrusive, yet informative status & tab lines
• Premium color-schemes
• Remembers last-used colorscheme

Screenshot

Prerequisites

• git ≥ 2.19.0 (brew install git)
• Neovim ≥ v0.10.0 (brew install neovim)

Optional, but highly recommended:

• bat (brew install bat)
• fd (brew install fd)
• fzf (brew install fzf)
• ripgrep (brew install ripgrep)
• zoxide (brew install zoxide)

Install

1. Let's clone this repo! Clone to ~/.config/nvim

   mkdir -p ~/.config
   git clone git@github.com:rafi/vim-config.git ~/.config/nvim
   cd ~/.config/nvim

2. Run nvim (will install all plugins the first time).

   It's highly recommended running :checkhealth to ensure your system is healthy and meet the requirements.

3. Inside Neovim, run :LazyExtras and use x to install extras.

Enjoy! 😄

Install LSP, DAP, Linters, Formatters

Use :Mason (or Space+mm) to install and manage LSP servers, DAP servers, linters and formatters. See :h mason.nvim and williamboman/mason.nvim for more information.

Language-Server Protocol (LSP)

You can install LSP servers using :Mason UI, or :MasonInstall <name>, or :LspInstall <name> (use Tab to list available servers). See Mason's PACKAGES.md for the official list, and the Language server mapping list. You can also view at :h mason-lspconfig-server-map

You'll need utilities like npm and curl to install some extensions, see requirements (or :h mason-requirements) for more information.

See lua/rafi/plugins/lsp/init.lua for custom key-mappings and configuration for some language-servers.

Recommended LSP

:MasonInstall ansible-language-server bash-language-server css-lsp
:MasonInstall dockerfile-language-server gopls html-lsp json-lsp
:MasonInstall lua-language-server marksman pyright sqlls
:MasonInstall svelte-language-server typescript-language-server
:MasonInstall tailwindcss-language-server
:MasonInstall vim-language-server yaml-language-server

and more…

Recommended Linters

:MasonInstall vint shellcheck editorconfig-checker flake8 gitlint hadolint
:MasonInstall markdownlint mypy selene shellharden write-good yamllint

Recommended Formatters

:MasonInstall black fixjson gofumpt golines isort
:MasonInstall shfmt sql-formatter stylua

Recommended Fonts

• Pragmata Pro (€19 — €1,990): My preferred font
• Any of the Nerd Fonts

On macOS with Homebrew, choose one of the Nerd Fonts, for example, here are some popular fonts:

brew tap homebrew/cask-fonts
brew search nerd-font
brew install --cask font-victor-mono-nerd-font
brew install --cask font-iosevka-nerd-font-mono
brew install --cask font-hack-nerd-font
brew install --cask font-fira-code

Upgrade

To upgrade packages and plugins:

• Neovim plugins: :Lazy update
• Mason packages: :Mason and press U

To update Neovim configuration from my repo:

git pull --ff --ff-only

Structure

• after/ — Language specific custom settings and plugins.
• lua/ — Lua configurations
  • config/ — Custom user configuration
  • plugins/ — Custom user plugins (or lua/plugins.lua)
  • rafi/
    • config/ — Neovim configurations
      • autocmd.lua — Auto-commands
      • init.lua — Initialization
      • keymaps.lua — Key-mappings
      • lazy.lua — Entry-point initialization
      • options.lua — Editor settings
    • plugins/ — Plugins and configurations
    • util/ — Utility library
• snippets/ — Personal code snippets

Extending

Extend: Config

Fork this repository and create a directory lua/config with one or more of these files: (Optional)

• lua/config/autocmds.lua — Custom auto-commands
• lua/config/options.lua — Custom options
• lua/config/keymaps.lua — Custom key-mappings
• lua/config/setup.lua — Override config, see extend defaults.

Adding plugins or override existing options:

• lua/plugins/*.lua or lua/plugins.lua — Plugins (See lazy.nvim specs for syntax)

Extend: Plugins

Install "extras" plugins using :LazyExtras and installing with x. This saves choices in lazyvim.json which you can also edit manually, here's a recommended starting point:

{
  "extras": [
    "lazyvim.plugins.extras.coding.copilot",
    "lazyvim.plugins.extras.dap.core",
    "lazyvim.plugins.extras.dap.nlua",
    "lazyvim.plugins.extras.lang.docker",
    "lazyvim.plugins.extras.lang.json",
    "lazyvim.plugins.extras.lang.typescript",
    "lazyvim.plugins.extras.lang.yaml",
    "lazyvim.plugins.extras.test.core",
    "rafi.plugins.extras.coding.align",
    "rafi.plugins.extras.editor.harpoon2",
    "rafi.plugins.extras.git.cmp-git",
    "rafi.plugins.extras.lang.ansible",
    "rafi.plugins.extras.lang.go",
    "rafi.plugins.extras.lang.helm",
    "rafi.plugins.extras.lang.markdown",
    "rafi.plugins.extras.lang.python",
    "rafi.plugins.extras.lang.tmux",
    "rafi.plugins.extras.ui.deadcolumn"
  ],
  "news": [],
  "version": 2
}

For installing/overriding/disabling plugins, create a lua/plugins/foo.lua file (or lua/plugins/foo/bar.lua or simply lua/plugins.lua) and manage your own plugin collection. You can add or override existing plugins' options, or just disable them all-together. Here's an example:

return {

  -- Disable default tabline
  { 'akinsho/bufferline.nvim', enabled = false },

  -- And choose a different one!
  -- { 'itchyny/lightline.vim' },
  -- { 'vim-airline/vim-airline' },
  -- { 'glepnir/galaxyline.nvim' },
  -- { 'glepnir/spaceline.vim' },
  -- { 'liuchengxu/eleline.vim' },

  -- Enable GitHub's Copilot
  { import = 'lazyvim.plugins.extras.coding.copilot' },

  -- Enable incline, displaying filenames on each window
  { import = 'rafi.plugins.extras.ui.incline' },

  -- Disable built-in plugins
  { 'shadmansaleh/lualine.nvim', enabled = false },
  { 'limorris/persisted.nvim', enabled = false },

  -- Change built-in plugins' options
  {
    'nvim-treesitter/nvim-treesitter',
    opts = {
      ensure_installed = {
        'bash', 'comment', 'css', 'diff', 'dockerfile', 'fennel', 'fish',
        'gitcommit', 'gitignore', 'gitattributes', 'git_rebase', 'go', 'gomod',
        'gosum', 'gowork', 'graphql', 'hcl', 'html', 'javascript', 'jsdoc',
        'json', 'json5', 'jsonc', 'jsonnet', 'lua', 'make', 'markdown',
        'markdown_inline', 'nix', 'perl', 'php', 'pug', 'python', 'regex',
        'rst', 'ruby', 'rust', 'scss', 'sql', 'svelte', 'terraform', 'toml',
        'tsx', 'typescript', 'vim', 'vimdoc', 'vue', 'yaml', 'zig',
      },
    },
  },

}

Extend: Defaults

1. Create lua/config/options.lua and set any Neovim/RafiVim/LazyVim features: (Default values are shown)

   -- Auto format on-save
   vim.g.autoformat = false
   
   -- Elite-mode (hjkl mode. arrow-keys resize window)
   vim.g.elite_mode = false
   
   -- When enabled, 'q' closes any window
   vim.g.window_q_mapping = true
   
   -- Display structure in statusline by default
   vim.g.structure_status = false

2. You can override LazyVim options. For example in lua/plugins/core.lua:

   return {
     {
       'LazyVim/LazyVim',
       opts = {
         icons = {
           diagnostics = {
             Error = '',
             Warn  = '',
             Info  = '',
           },
           status = {
             diagnostics = {
               error = 'E',
               warn  = 'W',
               info  = 'I',
               hint  = 'H',
             },
           },
         },
       },
     },
   }

3. You can override lazy.nvim (package-manager) global options. Create lua/config/setup.lua and return this function:

   • lazy_opts() — override LazyVim setup options

   For example:

   local M = {}
   
   ---@return table
   function M.lazy_opts()
     return {
       -- See https://github.com/folke/lazy.nvim/#%EF%B8%8F-configuration
       concurrency = jit.os:find('Windows') and (vim.uv.available_parallelism() * 2) or nil,
     }
   end
   
   return M

4. You can completely override lazy.nvim setup by creating lua/config/lazy.lua to replace lua/rafi/config/lazy.lua with your own procedure.

Extend: LSP Settings

Override server options with nvim-lspconfig plugin, for example:

{
  'neovim/nvim-lspconfig',
  opts = {
    servers = {
      yamlls = {
        filetypes = { 'yaml', 'yaml.ansible', 'yaml.docker-compose' },
      },
      lua_ls = {
        settings = {
          Lua = {
            workspace = { checkThirdParty = false },
            completion = { callSnippet = 'Replace' },
          },
        },
      },
    },
  }
}

Plugin Highlights

• Plugin management with cache and lazy loading for speed
• Auto-completion with Language-Server Protocol (LSP)
• Project-aware tabline
• Extensive syntax highlighting with nvim-treesitter.

Note that 95% of the plugins are lazy-loaded.

Plugins Included

List of plugins (🔎 Click to expand/collapse)

Completion & Code-Analysis

Name	Description
neovim/nvim-lspconfig	Quickstart configurations for the Nvim LSP client
williamboman/mason.nvim	Portable package manager for Neovim
williamboman/mason-lspconfig.nvim	Mason extension for easier lspconfig integration
stevearc/conform.nvim	Lightweight yet powerful formatter plugin
mfussenegger/nvim-lint	Asynchronous linter plugin

Editor Plugins

Name	Description
folke/lazy.nvim	Modern plugin manager for Neovim
nmac427/guess-indent.nvim	Automatic indentation style detection
tweekmonster/helpful.vim	Display vim version numbers in docs
lambdalisue/suda.vim	An alternative sudo for Vim and Neovim
folke/persistence.nvim	Simple lua plugin for automated session management
mbbill/undotree	Ultimate undo history visualizer
folke/flash.nvim	Search labels, enhanced character motions
haya14busa/vim-edgemotion	Jump to the edge of block
folke/zen-mode.nvim	Distraction-free coding for Neovim
folke/todo-comments.nvim	Highlight, list and search todo comments in your projects
folke/trouble.nvim	Pretty lists to help you solve all code diagnostics
akinsho/toggleterm.nvim	Persist and toggle multiple terminals
[hedyhli/outline.nvim]	Code outline sidebar powered by LSP
s1n7ax/nvim-window-picker	Fancy Window picker
dnlhc/glance.nvim	Pretty window for navigating LSP locations
nvim-pack/nvim-spectre	Find the enemy and replace them with dark power

Coding Plugins

Name	Description
hrsh7th/nvim-cmp	Completion plugin for neovim written in Lua
hrsh7th/cmp-nvim-lsp	nvim-cmp source for neovim builtin LSP client
hrsh7th/cmp-buffer	nvim-cmp source for buffer words
hrsh7th/cmp-path	nvim-cmp source for path
hrsh7th/cmp-emoji	nvim-cmp source for emoji
rafamadriz/friendly-snippets	Preconfigured snippets for different languages
windwp/nvim-autopairs	Powerful auto-pair plugin with multiple characters support
echasnovski/mini.surround	Fast and feature-rich surround actions
JoosepAlviste/nvim-ts-context-commentstring	Set the commentstring based on the cursor location
numToStr/Comment.nvim	Powerful line and block-wise commenting
echasnovski/mini.splitjoin	Split and join arguments
echasnovski/mini.trailspace	Trailing whitespace highlight and remove
AndrewRadev/linediff.vim	Perform diffs on blocks of code
AndrewRadev/dsf.vim	Delete surrounding function call
echasnovski/mini.ai	Extend and create a/i textobjects
folke/lazydev.nvim	Faster LuaLS setup
Bilal2453/luvit-meta	Manage libuv types with lazy

Colorscheme Plugins

Name	Description
rafi/theme-loader.nvim	Use last-used colorscheme
rafi/neo-hybrid.vim	Modern dark colorscheme, hybrid improved
rafi/awesome-colorschemes	Awesome color-schemes

Git Plugins

Name	Description
lewis6991/gitsigns.nvim	Git signs written in pure lua
sindrets/diffview.nvim	Tabpage interface for cycling through diffs
NeogitOrg/neogit	Magit clone for Neovim
FabijanZulj/blame.nvim	Git blame visualizer
rhysd/git-messenger.vim	Reveal the commit messages under the cursor
ruifm/gitlinker.nvim	Browse git repositories
rhysd/committia.vim	Pleasant editing on Git commit messages

Misc Plugins

Name	Description
hoob3rt/lualine.nvim	Statusline plugin written in pure lua
nvim-neo-tree/neo-tree.nvim	File explorer written in Lua
nvim-telescope/telescope.nvim	Find, Filter, Preview, Pick. All lua.
jvgrootveld/telescope-zoxide	Telescope extension for Zoxide
rafi/telescope-thesaurus.nvim	Browse synonyms for a word
nvim-lua/plenary.nvim	Lua functions library

Treesitter & Syntax

Name	Description
nvim-treesitter/nvim-treesitter	Nvim Treesitter configurations and abstraction layer
nvim-treesitter/nvim-treesitter-textobjects	Textobjects using treesitter queries
nvim-treesitter/nvim-treesitter-context	Show code context
RRethy/nvim-treesitter-endwise	Wisely add "end" in various filetypes
windwp/nvim-ts-autotag	Use treesitter to auto close and auto rename html tag
andymass/vim-matchup	Modern matchit and matchparen
iloginow/vim-stylus	Better vim plugin for stylus
mustache/vim-mustache-handlebars	Mustache and handlebars syntax
lifepillar/pgsql.vim	PostgreSQL syntax and indent
MTDL9/vim-log-highlighting	Syntax highlighting for generic log files
reasonml-editor/vim-reason-plus	Reason syntax and indent

UI Plugins

Name	Description
nvim-tree/nvim-web-devicons	Lua fork of vim-devicons
MunifTanjim/nui.nvim	UI Component Library
rcarriga/nvim-notify	Fancy notification manager
stevearc/dressing.nvim	Improve the default vim-ui interfaces
akinsho/bufferline.nvim	Snazzy tab/bufferline
echasnovski/mini.bufremove	Helper for removing buffers
folke/noice.nvim	Replaces the UI for messages, cmdline and the popupmenu
SmiteshP/nvim-navic	Shows your current code context in winbar/statusline
chentau/marks.nvim	Interacting with and manipulating marks
lukas-reineke/indent-blankline.nvim	Visually display indent levels
echasnovski/mini.indentscope	Visualize and operate on indent scope
folke/which-key.nvim	Create key bindings that stick
tenxsoydev/tabs-vs-spaces.nvim	Hint and fix deviating indentation
t9md/vim-quickhl	Highlight words quickly
kevinhwang91/nvim-bqf	Better quickfix window

Extra Plugins

List of extras (🔎 Click to expand/collapse)

You can view all LazyVim's extras at www.lazyvim.org/extras.

These plugins aren't enabled by default. You'll have to install them using :LazyExtras and installing with x. (Or import them using specs) See Extend: Plugins on how to add plugins and examples.

Following are extra-extras available with Rafi's Neovim on-top of LazyVim's:

Extra Plugins: Coding

Spec: rafi.plugins.extras.coding.<name>

Name	Repository	Description
align	echasnovski/mini.align	Align text interactively
chainsaw	chrisgrieser/nvim-chainsaw	Create log statements on the fly
editorconfig	sgur/vim-editorconfig	EditorConfig plugin written entirely in Vimscript
emmet	mattn/emmet-vim	Provides support for expanding abbreviations alá emmet
luasnip	L3MON4D3/LuaSnip saadparwaiz1/cmp_luasnip	Snippet Engine and cmp source
mini-pairs	echasnovski/mini.pairs	Automatically manage character pairs
neogen	danymat/neogen	Annotation generator
sandwich	machakann/vim-sandwich	Search, select, and edit sandwich text objects

Extra Plugins: Colorscheme

Spec: rafi.plugins.extras.colorscheme.<name>

Name	Repository	Description
nordic	AlexvZyl/nordic.nvim	Nord for Neovim, but warmer and darker
tokyonight	folke/tokyonight.nvim	Clean, dark Neovim theme
kanagawa	rebelot/kanagawa.nvim	Inspired by the colors of the famous painting by Katsushika Hokusai
onedarkpro	olimorris/onedarkpro.nvim	OneDarkPro theme
nightfox	EdenEast/nightfox.nvim	Highly customizable theme
oxocarbon	nyoom-engineering/oxocarbon.nvim	Dark and light theme inspired by IBM Carbon
bamboo	ribru17/bamboo.nvim	Warm green theme
catppuccin	catppuccin/nvim	Soothing pastel theme

Extra Plugins: Editor

Spec: rafi.plugins.extras.editor.<name>

Name	Repository	Description
anyjump	pechorin/any-jump.vim	Jump to any definition and references without overhead
flybuf	glepnir/flybuf.nvim	List buffers in a float window
harpoon	ThePrimeagen/harpoon	Marks for navigating your project
mini-visits	echasnovski/mini.visits	Track and reuse file system visits
rest	rest-nvim/rest.nvim	Fast Neovim http client written in Lua
sidebar	sidebar-nvim/sidebar.nvim	Generic and modular lua sidebar
ufo	kevinhwang91/nvim-ufo	Make folds look modern and keep a high performance

Extra Plugins: Git

Spec: rafi.plugins.extras.git.<name>

Name	Repository	Description
cmp-git	petertriho/cmp-git	Git source for nvim-cmp
fugitive	tpope/vim-fugitive	Git client, including junegunn/gv.vim

Extra Plugins: Lang

Spec: rafi.plugins.extras.lang.<name>

Name	Description
ansible	imports lazyvim.plugins.extras.lang.ansible, add syntax and pearofducks/ansible-vim
go	imports lazyvim.plugins.extras.lang.go, add tools, patterns, etc.
helm	imports lazyvim.plugins.extras.lang.helm, add filetype patterns
kubernetes	imports lazyvim.plugins.extras.lang.yaml, add filetype patterns
markdown	imports lazyvim.plugins.extras.lang.markdown, disable headlines, add mzlogin/vim-markdown-toc
python	imports lazyvim.plugins.extras.lang.python, add syntax and filetype patterns
tmux	syntax, completion andersevenrud/cmp-tmux, keymaps christoomey/tmux-navigator

Extra Plugins: LSP

Spec: rafi.plugins.extras.lsp.<name>

Key	Name	Description
gtd	hrsh7th/nvim-gtd	LSP's go-to definition plugin
lightbulb	kosayoda/nvim-lightbulb	VSCode 💡 for neovim's built-in LSP
yaml-companion	yaml-companion.nvim	Get, set and autodetect YAML schemas in your buffers

Extra Plugins: Org

Spec: rafi.plugins.extras.org.<name>

Key	Name	Description
calendar	itchyny/calendar.vim	Calendar application
kiwi	serenevoid/kiwi.nvim	Stripped down VimWiki
telekasten	renerocksai/telekasten.nvim	Manage text-based, markdown zettelkasten or wiki with telescope
vimwiki	vimwiki/vimwiki	Personal Wiki for Vim
zk-nvim	zk-org/zk-nvim	Extension for the zk plain text note-taking assistant

Extra Plugins: Treesitter

Spec: rafi.plugins.extras.treesitter.<name>

Key	Name	Description
treesj	Wansmer/treesj	Splitting and joining blocks of code

Extra Plugins: UI

Spec: rafi.plugins.extras.ui.<name>

Key	Name	Description
alpha	goolord/alpha-nvim	Fast and fully programmable greeter
barbecue	utilyre/barbecue.nvim	VS Code like winbar
ccc	uga-rosa/ccc.nvim	Super powerful color picker/colorizer plugin
cursorword	itchyny/cursorword	Underlines word under cursor
cybu	ghillb/cybu.nvim	Cycle buffers with a customizable notification window
deadcolumn	Bekaboo/deadcolumn.nvim	Show colorcolumn dynamically
goto-preview	rmagatti/goto-preview	Preview definitions using floating windows
headlines	lukas-reineke/headlines.nvim	Adds horizontal highlights for headlines and code background.
illuminate	RRethy/vim-illuminate	Highlights other uses of the word under the cursor
incline	b0o/incline.nvim	Floating statuslines
mini-clue	echasnovski/mini.clue	Show next key clues
mini-map	echasnovski/mini.map	Window with buffer text overview, scrollbar and highlights
render-markdown	MeanderingProgrammer/markdown.nvim	Improve viewing Markdown files
symbols-outline	simrat39/symbols-outline.nvim	Tree like view for symbols using LSP

LazyVim Extras

LazyVim is imported in specs (see lua/rafi/config/lazy.lua) Therefore, you can import any of the "Extras" plugins defined at LazyVim/LazyVim and documented in lazyvim.org.

These are only highlights:

Language

• lazyvim.plugins.extras.lang.json
• lazyvim.plugins.extras.lang.markdown
• lazyvim.plugins.extras.lang.terraform
• lazyvim.plugins.extras.lang.typescript

DAP (Debugging)

• Spec: lazyvim.plugins.extras.dap.<name>
• See lazyvim/plugins/extras/dap

Test

• Spec: lazyvim.plugins.extras.test.<name>
• See lazyvim/plugins/extras/test

Custom Key-mappings

Note that,

• Leader key set as Space
• Local-Leader key set as ; and used for navigation and search (Telescope and Neo-tree)
• Disable ← ↑ → ↓ in normal mode by enabling elite_mode.

Key-mappings (🔎 Click to expand/collapse)

Modes: 𝐍=normal 𝐕=visual 𝐒=select 𝐈=insert 𝐎=operator 𝐂=command

Navigation

Key	Mode	Action	Plugin or Mapping
j / k	𝐍 𝐕	Cursor moves through display-lines	g j/k
gj / gk	𝐍 𝐕 𝐒	Jump to edge upward/downward	haya14busa/vim-edgemotion
gh / gl	𝐍 𝐕	Easier line-wise movement	g^ g$
zl / zh	𝐍	Scroll horizontally and vertically wider	z4 l/h
Ctrl+j	𝐍	Move to split below	<C-w>j or christoomey/tmux-navigator
Ctrl+k	𝐍	Move to upper split	<C-w>k or christoomey/tmux-navigator
Ctrl+h	𝐍	Move to left split	<C-w>h or christoomey/tmux-navigator
Ctrl+l	𝐍	Move to right split	<C-w>l or christoomey/tmux-navigator
Return	𝐍	Toggle fold under cursor	za
Shift+Return	𝐍	Focus the current fold by closing all others	zMzv
Ctrl+f	𝐂	Move cursor forwards in command	Right
Ctrl+b	𝐂	Move cursor backwards in command	Left
Ctrl+h	𝐂	Move cursor to the beginning in command	Home
Ctrl+l	𝐂	Move cursor to the end in command	End
Ctrl+Tab	𝐍	Go to next tab	:tabnext
Ctrl+ShiftTab	𝐍	Go to previous tab	:tabprevious
Alt+j or ]	𝐍	Go to next tab	:tabnext
Alt+k or [	𝐍	Go to previous tab	:tabprevious
Alt+{	𝐍	Move tab backward	:-tabmove
Alt+}	𝐍	Move tab forward	:+tabmove

Selection

Key	Mode	Action	Plugin or Mapping
Space+Space	𝐍 𝐕	Toggle visual-line mode	V / Escape
v / V	𝐕	Increment/shrink selection	nvim-treesitter
vsp	𝐍	Select last paste	config/keymaps.lua
sg	𝐕	Replace within selected area	config/keymaps.lua
Ctrl+r	𝐕	Replace selection with step-by-step confirmation	config/keymaps.lua
> / <	𝐕	Indent and re-select	config/keymaps.lua
Tab / Shift+Tab	𝐕	Indent and re-select	config/keymaps.lua
I / gI / A	𝐕	Force blockwise operation	config/keymaps.lua

Jump To

Key	Mode	Action	Plugin or Mapping
], or [,	𝐍	Next/previous parameter	akinsho/bufferline.nvim
]q or [q	𝐍	Next/previous on quick-fix	:cnext / :cprev
]a or [a	𝐍	Next/previous on location-list	:lnext / :lprev
]d or [d	𝐍	Next/previous diagnostics	config/keymaps.lua
]e or [e	𝐍	Next/previous error	config/keymaps.lua
]w or [w	𝐍	Next/previous warning	config/keymaps.lua
]b or [b	𝐍	Next/previous buffer	akinsho/bufferline.nvim
]f or [f	𝐍	Next/previous function start	echasnovski/mini.ai
]F or [F	𝐍	Next/previous function end	echasnovski/mini.ai
]c or [c	𝐍	Next/previous class start	echasnovski/mini.ai
]C or [C	𝐍	Next/previous class end	echasnovski/mini.ai
]m or [m	𝐍	Next/previous method start	echasnovski/mini.ai
]M or [M	𝐍	Next/previous method end	echasnovski/mini.ai
]g or [g	𝐍	Next/previous Git hunk	lewis6991/gitsigns.nvim
]i or [i	𝐍	Next/previous indent scope	echasnovski/mini.indentscope
]t or [t	𝐍	Next/previous TODO	folke/todo-comments.nvim
]z or [z	𝐍	Next/previous whitespace error	config/keymaps.lua

Buffers

Key	Mode	Action	Plugin or Mapping
Space+bd	𝐍	Delete buffer	echasnovski/mini.bufremove

Clipboard

Key	Mode	Action	Plugin or Mapping
p or P	𝐕	Paste without yank	:let @+=@0
Space+y	𝐍	Copy relative file-path to clipboard	config/keymaps.lua
Space+Y	𝐍	Copy absolute file-path to clipboard	config/keymaps.lua

Auto-Completion

Key	Mode	Action	Plugin or Mapping
Tab / Shift-Tab	𝐈 𝐒	Navigate/open completion-menu	nvim-cmp
Tab / Shift-Tab	𝐈 𝐒	Navigate snippet placeholders	L3MON4D3/LuaSnip
Ctrl+Space	𝐈	Open completion menu	nvim-cmp
Enter	𝐈	Select completion item or expand snippet	nvim-cmp
Shift+Enter	𝐈	Select and replace with completion item	nvim-cmp
Ctrl+n/p	𝐈	Movement in completion pop-up	nvim-cmp
Ctrl+f/b	𝐈	Scroll documentation	nvim-cmp
Ctrl+d/u	𝐈	Scroll candidates	nvim-cmp
Ctrl+e	𝐈	Abort selection and close pop-up	nvim-cmp
Ctrl+l	𝐈	Expand snippet at cursor	L3MON4D3/LuaSnip
Ctrl+c	𝐈	Close completion menu	nvim-cmp

LSP

Key	Mode	Action	Plugin or Mapping
gr	𝐍	Go to references	plugins/lsp/keymaps.lua
gR	𝐍	List references with Trouble	folke/trouble.nvim
gd	𝐍	Go to definition	plugins/lsp/keymaps.lua
gD	𝐍	Go to declaration	plugins/lsp/keymaps.lua
gI	𝐍	Go to implementation	plugins/lsp/keymaps.lua
gy	𝐍	Go to type definition	plugins/lsp/keymaps.lua
K	𝐍	Show hover help or collapsed fold	plugins/lsp/keymaps.lua
gK	𝐍	Show signature help	plugins/lsp/keymaps.lua
Space cl	𝐍	Open LSP info window	plugins/lsp/keymaps.lua
Space cr	𝐍	Rename	plugins/lsp/keymaps.lua
Space ce	𝐍	Open diagnostics window	plugins/lsp/keymaps.lua
Space co	𝐍	Formatter menu selection	plugins/lsp/keymaps.lua
Space ca	𝐍 𝐕	Code action	plugins/lsp/keymaps.lua
Space cA	𝐍	Source action	plugins/lsp/keymaps.lua
Space chi	𝐍	LSP incoming calls	plugins/lsp/keymaps.lua
Space cho	𝐍	LSP outgoing calls	plugins/lsp/keymaps.lua
Space ud	𝐍	Toggle buffer diagnostics	plugins/lsp/keymaps.lua
Space uD	𝐍	Toggle global diagnostics	plugins/lsp/keymaps.lua
Space fwa	𝐍	Add workspace folder	plugins/lsp/keymaps.lua
Space fwr	𝐍	Remove workspace folder	plugins/lsp/keymaps.lua
Space fwl	𝐍	List workspace folders	plugins/lsp/keymaps.lua
gpd	𝐍	Glance definitions	dnlhc/glance.nvim
gpr	𝐍	Glance references	dnlhc/glance.nvim
gpy	𝐍	Glance type definitions	dnlhc/glance.nvim
gpi	𝐍	Glance implementations	dnlhc/glance.nvim

Diagnostics

Key	Mode	Action	Plugin or Mapping
Space xt	𝐍	List TODO with Trouble	folke/todo-comments.nvim
Space xT	𝐍	List TODO/FIXME with Trouble	folke/todo-comments.nvim
Space st	𝐍	Select TODO with Telescope	folke/todo-comments.nvim
Space sT	𝐍	Select TODO/FIXME with Telescope	folke/todo-comments.nvim
Space xx	𝐍	Toggle Trouble	folke/trouble.nvim
Space xd	𝐍	Toggle Trouble document	folke/trouble.nvim
Space xw	𝐍	Toggle Trouble workspace	folke/trouble.nvim
Space xq	𝐍	Toggle Quickfix via Trouble	folke/trouble.nvim
Space xl	𝐍	Toggle Locationlist via Trouble	folke/trouble.nvim

Coding

Key	Mode	Action	Plugin or Mapping
Ctrl+q	𝐍	Start recording macro	q
Space cf	𝐍 𝐕	Format	[plugins/formatting.lua]
Space cF	𝐍 𝐕	Format injected langs	[plugins/formatting.lua]
Space cc	𝐍	Generate doc annotations	danymat/neogen
Shift+Return	𝐈	Start new line from any cursor position	<C-o>o
] Space	𝐍	Add new line below	o<Esc>
[ Space	𝐍	Add new line above	O<Esc>
gc	𝐍 𝐕	Comment prefix	numToStr/Comment.nvim
gcc	𝐍 𝐕	Toggle comments	numToStr/Comment.nvim
Space+j or k	𝐍 𝐕	Move lines down/up	:m …
Space+v	𝐍 𝐕	Toggle line-wise comments	numToStr/Comment.nvim
Space+V	𝐍 𝐕	Toggle block-wise comments	numToStr/Comment.nvim
Space+dd	𝐍 𝐕	Duplicate line or selection	config/keymaps.lua
Space+cw	𝐍	Remove all spaces at EOL	echasnovski/mini.trailspace
sj / sk	𝐍	Join/split arguments	echasnovski/mini.splitjoin
dsf / csf	𝐍	Delete/change surrounding function call	AndrewRadev/dsf.vim

Search, Substitute, Diff

Key	Mode	Action	Plugin or Mapping
* / #	𝐍 𝐕	Search partial words	g* / g#
g* / g#	𝐍 𝐕	Search whole-word forward/backward	* / #
Escape	𝐍	Clear search highlight	:nohlsearch
Backspace	𝐍	Match bracket	%
Space+bf	𝐍	Diff current windows in tab	windo diffthis
ss	𝐍 𝐕 𝐎	Flash jump	folke/flash.nvim
S	𝐍 𝐕 𝐎	Flash treesitter	folke/flash.nvim
r	𝐎	Flash remote	folke/flash.nvim
R	𝐕 𝐎	Flash treesitter search	folke/flash.nvim
Ctrl+s	𝐂	Toggle flash in search input	folke/flash.nvim

Command & History

Key	Mode	Action	Plugin or Mapping
g!	𝐍	Read vim command into buffer	:put=execute('⌴')
Ctrl+n / p	𝐂	Switch history search pairs	↓ / ↑
↓ / ↑	𝐂	Switch history search pairs	Ctrl n/p

File Operations

Key	Mode	Action	Plugin or Mapping
Space+cd	𝐍	Switch tab to the directory of current buffer	:tcd %:p:h
Space+w	𝐍	Write buffer to file	:write
Ctrl+s	𝐍 𝐕 𝐂	Write buffer to file	:write

Editor UI

Key	Mode	Action	Plugin or Mapping
Space ub	𝐍	Toggle structure scope in winbar	SmiteshP/nvim-navic
Space uf	𝐍	Toggle format on Save	config/keymaps.lua
Space us	𝐍	Toggle spell-checker	:setlocal spell!
Space ul	𝐍	Toggle line numbers	:setlocal nonumber!
Space uL	𝐍	Toggle relative line numbers	:setlocal norelativenumber!
Space uo	𝐍	Toggle hidden characters	:setlocal nolist!
Space uu	𝐍	Toggle highlighted search	:set hlsearch!
Space uw	𝐍	Toggle wrap	:setlocal wrap! …
Space ue	𝐍	Toggle indentation lines	lukas-reineke/indent-blankline.nvim
Space uh	𝐍	Toggle inlay-hints	config/keymaps.lua
Space ui	𝐍	Show highlight groups for word	vim.show_pos
Space up	𝐍	Disable auto-pairs	windwp/nvim-autopairs
Space ur	𝐍	Redraw, clear hlsearch, and diff update	config/keymaps.lua
Space un	𝐍	Dismiss all notifications	rcarriga/nvim-notify

Window Management

Key	Mode	Action	Plugin or Mapping
q	𝐍	Quit window (if last window, quit nvim)	:quit
Ctrl+x	𝐍	Rotate window placement	C-w x
sp	𝐍	Choose a window to edit	s1n7ax/nvim-window-picker
sw	𝐍	Switch editing window with selected	s1n7ax/nvim-window-picker
sv	𝐍	Horizontal split	:split
sg	𝐍	Vertical split	:vsplit
st	𝐍	Open new tab	:tabnew
so	𝐍	Close other windows	:only
sb	𝐍	Previous buffer	:b#
sc	𝐍	Close current buffer	:close
sd	𝐍	Delete buffer	:bdelete
sq	𝐍	Quit window	:quit
sx	𝐍	Delete buffer, leave blank window	:enew │ bdelete
sz	𝐍	Toggle window zoom	:vertical resize │ resize
sh	𝐍	Toggle colorscheme background=dark/light	:set background …

Plugins

Key	Mode	Action	Plugin or Mapping
;+c	𝐍	Open context-menu	lua/rafi/util/contextmenu.lua
gCtrl+o	𝐍	Navigate to previous file on jumplist	util/edit.lua
gCtrl+i	𝐍	Navigate to next file on jumplist	util/edit.lua
Ctrl+/	𝐍	Toggle terminal	akinsho/toggleterm.nvim
Space l	𝐍	Open Lazy	folke/lazy.nvim
Space o	𝐍	Open Outline side	[hedyhli/outline.nvim]
Space ?	𝐍	Open the macOS dictionary on current word	:!open dict://
Space cp	𝐍	Toggle Markdown preview	iamcco/markdown-preview.nvim
Space mc	𝐍	Open color-picker	uga-rosa/ccc.nvim
Space tt	𝐍	Open terminal (root dir)	config/keymaps.lua
Space tT	𝐍	Open terminal (cwd)	config/keymaps.lua
Space tg	𝐍	Open Lazygit (root dir)	config/keymaps.lua
Space tG	𝐍	Open Lazygit (cwd)	config/keymaps.lua
Space gu	𝐍	Open undo-tree	mbbill/undotree
Space gb	𝐍	Git blame	FabijanZulj/blame.nvim
Space gB	𝐍	Git blame in window	FabijanZulj/blame.nvim
Space gm	𝐍	Reveal commit under cursor	rhysd/git-messenger.vim
Space go	𝐍 𝐕	Open SCM detailed URL in browser	ruifm/gitlinker.nvim
Space mg	𝐍	Open Neogit	NeogitOrg/neogit
Space ml	𝐍	Append modeline to end of buffer	config/keymaps.lua
Space mda	𝐕	Sequentially mark region for diff	AndrewRadev/linediff.vim
Space mdf	𝐕	Mark region for diff and compare if more than one	AndrewRadev/linediff.vim
Space mds	𝐍	Shows the comparison for all marked regions	AndrewRadev/linediff.vim
Space mdr	𝐍	Removes the signs denoting the diff regions	AndrewRadev/linediff.vim
Space mh	𝐍	Open HTTP Rest UI	rest-nvim/rest.nvim
Space mt	𝐍 𝐕	Toggle highlighted word	t9md/vim-quickhl
Space mo	𝐍	Update Markdown TOC	mzlogin/vim-markdown-toc
Space zz	𝐍	Toggle distraction-free writing	folke/zen-mode.nvim

Plugin: Mini.Surround

See echasnovski/mini.surround for more mappings and usage information.

Key	Mode	Action
sa & movement	𝐍 𝐕	Add surrounding
cs & movement	𝐍	Replace surrounding
ds & movement	𝐍	Delete surrounding
gzf & movement	𝐍	Find surrounding (to the right)
gzF & movement	𝐍	Find surrounding (to the left)
gzh & movement	𝐍	Highlight surrounding
gzn & movement	𝐍	Update neighbor lines

Plugin: Gitsigns

See lewis6991/gitsigns.nvim for more mappings and usage information.

Key	Mode	Action
]g or ]g	𝐍	Next/previous Git hunk
gs	𝐍	Preview hunk
Space hp	𝐍	Preview hunk inline
Space hb	𝐍	Blame line
Space hs	𝐍 𝐕	Stage hunk
Space hr	𝐍 𝐕	Reset hunk
Space hu	𝐍	Undo stage hunk
Space hS	𝐍	Stage buffer
Space hR	𝐍	Reset buffer
Space hd	𝐍	Diff against the index
Space hD	𝐍	Diff against the last commit
Space hw	𝐍	Toggle word diff
Space hl	𝐍	Publish hunks to location-list
Space htb	𝐍	Toggle git current line blame
Space htd	𝐍	Toggle git deleted
Space htw	𝐍	Toggle git word diff
Space htl	𝐍	Toggle git line highlight
Space htn	𝐍	Toggle git number highlight
Space hts	𝐍	Toggle git signs
ih	𝐎	Select inner hunk operator

Plugin: Diffview

See sindrets/diffview.nvim for more mappings and usage information.

Key	Mode	Action
Space gd	𝐍	Diff view file history
Space gv	𝐍	Diff view open
Within diffview "view" window
Tab / Shift+Tab	𝐍	Select next/previous entry
; a	𝐍	Focus file
; e	𝐍	Toggle files panel
Within diffview "file" panel
q	𝐍	Close
h	𝐍	Previous entry
o	𝐍	Focus entry
gf	𝐍	Open file
sg	𝐍	Open file in split
st	𝐍	Open file in new tab
Ctrl+r	𝐍	Refresh files
; e	𝐍	Toggle panel
Within diffview "history" panel
q	𝐍	Close diffview
o	𝐍	Focus entry
O	𝐍	Show options

Plugin: Telescope

See telescope.nvim for more mappings and usage information.

Key	Mode	Action
;r	𝐍	Results of the previous picker
;p	𝐍	List of the previous pickers
;f	𝐍	File search
;g	𝐍	Grep search
;b	𝐍	Buffers
;h	𝐍	Highlights
;j	𝐍	Jump points
;m	𝐍	Marks
;o	𝐍	Vim options
;t	𝐍	LSP workspace symbols
;v	𝐍 𝐕	Yank history
;n	𝐍	Plugins
;k	𝐍	Thesaurus
;u	𝐍	Spelling suggestions
;x	𝐍	Old files
;w	𝐍	Zk notes
;z	𝐍	Zoxide directories
;;	𝐍	Command history
;:	𝐍	Commands
;/	𝐍	Search history
;dd	𝐍	LSP definitions
;di	𝐍	LSP implementations
;dr	𝐍	LSP references
;da	𝐍 𝐕	LSP code actions
Space /	𝐍	Buffer fuzzy find
Space gs	𝐍	Git status
Space gr	𝐍	Git branches
Space gl	𝐍	Git commits
Space gL	𝐍	Git buffer commits
Space gh	𝐍	Git stashes
Space gt	𝐍	Find symbols matching word under cursor
Space gf	𝐍	Find files matching word under cursor
Space gg	𝐍 𝐕	Grep word under cursor
Space sc	𝐍	Colorschemes
Space sd	𝐍	Document diagnostics
Space sD	𝐍	Workspace diagnostics
Space sh	𝐍	Help tags
Space sk	𝐍	Key-maps
Space sm	𝐍	Man pages
Space ss	𝐍	LSP document symbols
Space sS	𝐍	LSP workspace symbols
Space st	𝐍	Todo list
Space sT	𝐍	Todo/Fix/Fixme list
Space sw	𝐍	Grep string
Within Telescope window
?	𝐍	Keymaps help screen
Ctrl+Space	𝐍	Move from none fuzzy search to fuzzy
jj or Escape	𝐈	Leave Insert mode
i	𝐍	Enter Insert mode (filter input)
q or Escape	𝐍	Exit Telescope
Tab or Shift+Tab	𝐍 𝐈	Next/previous candidate
Ctrl+d/u	𝐍 𝐈	Scroll down/upwards
Ctrl+f/b	𝐍 𝐈	Scroll preview down/upwards
Ctrl+j/k	𝐍 𝐈	Scroll preview vertically
Ctrl+h/l	𝐍 𝐈	Scroll preview horizontally
J or K	𝐍	Select candidates up/downwards
st	𝐍	Open in a new tab
sg	𝐍	Open in a vertical split
sv	𝐍	Open in a split
*	𝐍	Toggle selection
u	𝐍	Drop all
w	𝐍	Smart send to quickfix list
e	𝐍	Send to quickfix list
Ctrl+q	𝐈	Send to quickfix list
dd	𝐍	Delete entry (buffer list)
!	𝐍	Edit in command line

Plugin: Neo-Tree

See nvim-neo-tree/neo-tree.nvim for more mappings and usage information.

Key	Mode	Action
fe / Spacee	𝐍	Toggle file explorer (root)
fE / SpaceE	𝐍	Toggle file explorer (cwd)
ge	𝐍	Open Git explorer
be	𝐍	Open Buffer explorer
xe	𝐍	Open Document explorer
;a	𝐍	Focus current file in file-explorer
Within Neo-Tree window
g?	𝐍	Show help
q	𝐍	Close window
j or k	𝐍	Move up and down the tree
Tab or Shift+Tab	𝐍	Next or previous source
]g or [g	𝐍	Jump to next/previous git modified node
l	𝐍	Toggle collapse/expand directory or open file
h	𝐍	Collapse directory tree
Return	𝐍	Select window to open file
gr	𝐍	Grep in current position
gf	𝐍	Find files in current position
.	𝐍	Set as root directory
Backspace	𝐍	Change into parent directory
sv or S	𝐍	Open file in a horizontal split
sg or s	𝐍	Open file in a vertical split
st or t	𝐍	Open file in new tab
p	𝐍	Preview toggle
a	𝐍	Create new directories and/or files
N	𝐍	Create new directory
r	𝐍	Rename file or directory
dd	𝐍	Delete
c / m	𝐍	Copy/move
y / x / P	𝐍	Clipboard copy/cut/paste
!	𝐍	Filter
D	𝐍	Filter directories
#	𝐍	Fuzzy sorter
F	𝐍	Filter on submit
Ctrl+c	𝐍	Clear filter
Ctrl+r or R	𝐍	Refresh
fi / fe	𝐍	Include/exclude
H	𝐍	Toggle hidden files
e	𝐍	Toggle auto-expand window width
w	𝐍	Toggle window width
z	𝐍	Collapse all nodes

Plugin: Spectre

See nvim-pack/nvim-spectre for more mappings and usage information.

Key	Mode	Action
Space+sp	𝐍	Open Spectre window (search & replace)
Space+sp	𝐕	Open Spectre with selection

Plugin: Marks

See chentau/marks.nvim for more mappings and usage information.

Key	Mode	Action
m,	𝐍	Set the next available alphabetical (lowercase) mark
m;	𝐍	Toggle the next available mark at the current line
m a-z	𝐍	Set mark
dm a-z	𝐍	Remove mark
dm-	𝐍	Delete all marks on the current line
dm<Space>	𝐍	Delete all marks in the current buffer
m]	𝐍	Move to next mark
m[	𝐍	Move to previous mark
m: a-z	𝐍	Preview mark
m/	𝐍	List marks from all opened buffers

Plugin: Zk

See zk-org/zk-nvim and zk for more mappings and usage information.

Key	Mode	Action
Space+zn	𝐍	Ask for title and create new note
Space+zo	𝐍	Browse notes sorted by modification time
Space+zt	𝐍	Browse tags
Space+zf	𝐍	Search notes
Space+zf	𝐕	Search notes with selection
Space+zb	𝐍	Show backlinks
Space+zl	𝐍	Show links