nix-config/home/base/desktop/neovim

AstroNvim Configuration and Shortcuts

My Neovim config based on AstroNvim. For more details, visit the AstroNvim website.

This document outlines neovim's configuration structure and various shortcuts/commands for efficient usage.

Configuration Structure

Description	Standard Location	My Location
Neovim's config	~/.config/nvim	AstroNvim's github repository, referenced as a flake input in this flake.
AstroNvim's user configuration	$XDG_CONFIG_HOME/astronvim/lua/user	./astronvim_user/
Plugins installation directory (lazy.nvim)	~/.local/share/nvim/	The same as standard location, generated and managed by lazy.nvim.
LSP servers, DAP servers, linters, and formatters	~/.local/share/nvim/mason/(by mason.nvim)	./default.nix, installed by nix.

Update/Clean Plugins

Note that lazy.nvim will not automatically update plugins, so you need to update them manually.

:Lazy update

Remove all unused plugins:

:Lazy clean

Screenshots

Visual Modes

Action	Shortcut
Toggle visual mode	v
Toggle visual block mode	<Ctrl> + v (select a block vertically)

Incremental Selection

Provided by nvim-treesitter.

Action	Shortcut
init selection	<Ctrl-space>
node incremental	<Ctrl-space>
scope incremental	<Alt-Space>
node decremental	Backspace

Search and Jump

Provided by flash.nvim, it's a intelligent search and jump plugin.

1. It enhaces the default search and jump behavior of neovim.(search with prefix /)

Action	Shortcut
Search	/(normal search), s(disable all code highlight, only highlight matches)
Treesitter Search	yR,dR, cR, vR, ctrl+v+R(arround your matches, all the surrounding Treesitter nodes will be labeled)
Remote Flash	yr, dr, cr, (arround your matches, all the surrounding Treesitter nodes will be labeled)

Text Manipulation

• Add at the end of multiple lines: :normal A<text>

  • Execublock: :A<text>

  • visual block mode(ctrl + v)

  • Append text at the end of each line in the selected block

  • If position exceeds line end, neovim adds spaces automatically

• Delete the last char of multivle lines: :normal $x

  • Execute $x on each line
  • visual mode(v)
  • $ moves cursor to the end of line
  • x deletes the character under the cursor

• Delete the last word of multiple lines: :normal $bD

  • Execute $bD on each line
  • visual mode(v)
  • $ moves cursor to the end of line
  • b moves cursor to the beginning of the last word
  • D deletes from cursor to the end of line

Commands & Shortcuts

Action	Shortcut
Learn Neovim's Basics	:Tutor
Open file explorer	<Space> + e
Focus Neotree to current file	<Space> + o
Floating Terminal	<Space> + tf
Horizontal Split Terminal	<Space> + th
Vertical Split Terminal	<Space> + tv
Open IPython REPL	<Space> + tp
Toggle line wrap	<Space> + uw
Show line diagnostics	gl
Show function/variable info	K
Go to definition	gd
References of a symbol	gr

Window Navigation

• Switch between windows: <Ctrl> + h/j/k/l
• Resize windows: <Ctrl> + Up/Down/Left/Right
  • Note: On macOS, conflicts with system shortcuts
  • Disable in System Preferences -> Keyboard -> Shortcuts -> Mission Control

Splitting and Buffers

Action	Shortcut
Horizontal Split	\
Vertical Split	|
Next Buffer (Tab)	]b
Previous Buffer (Tab)	[b
Close Buffer	<Space> + c

Editing and Formatting

Action	Shortcut
Toggle buffer auto formatting	<Space> + uf
Format Document	<Space> + lf
Code Actions	<Space> + la
Rename	<Space> + lr
Opening LSP symbols	<Space> + lS
Comment Line(support multiple lines)	<Space> + /
Open filepath/URL at cursor(neovim's builtin command)	gx
Find files by name (fzf)	<Space> + ff
Grep string in files (ripgrep)	<Space> + fw

Sessions

Action	Shortcut
Save Session	<Space> + Ss
Last Session	<Space> + Sl
Delete Session	<Space> + Sd
Search Session	<Space> + Sf
Load Current Directory Session	<Space> + S.

Debugging

Press <Space> + D to view available bindings and options.

Find and Replace

Action	Command
Replace in selected area	:s/old/new/g
Replace in current line	Same as above
Replace in whole file	:% s/old/new/g
Replace with regex	:% s@\vhttp://(\w+)@https://\1@gc

1. \v means means that in the regex pattern after it can be used without backslash escaping(similar to python's raw string).
2. \1 means the first matched group in the pattern.

Replace in the specific lines

Action	Command
From the 10th line to the end of the file	:10,$ s/old/new/g or :10,$ s@^@#@g
From the 10th line to the 20th line	:10,20 s/old/new/g

The postfix(flags) in the above commands:

1. g means replace all the matched strings in the current line/file.
2. c means ask for confirmation before replacing.
3. i means ignore case.

Search and Replace Globally

Description	Shortcut
Open spectre.nvim search and replace panel	<Space> + ss
Search and replace in command line(need install sad first)	find -name "*.nix" | sad '<pattern>' '<replacement>' | delta

Surrounding Characters

Provided by mini.surround plugin.

• Prefix gz

Action	Shortcut	Description
Add surrounding characters	gzaiw'	Add ' around the word under cursor
Delete surrounding characters	gzd'	Delete ' around the word under cursor
Replace surrounding characters	gzr'"	Replace ' by " around the word under cursor
Highlight surrounding	gzh'	Highlight ' around the word under cursor

Text Manipulation

Action
Join Selection of Lines With Space	:join
Join without spaces	:join!
Join with LSP intelligence(treesj)	<Space> + j
Split Line into Multiple Lines(treesj)	<Space> + s

Convert Text Case

Action
Toggle text's case	~
Convert to uppercase	U
Convert to lowercase	u

Miscellaneous

Action
Save selected text to a file	:w filename (Will show :'<,'>w filename)
Show all Yank History	:<Space> + yh
Show undo history	:<Space> + uh

Additional Resources

For more detailed information and advanced usage, refer to:

1. AstroNvim walkthrough
2. ./astronvim_user/mapping.lua
3. All the plugins' documentations