This repo hosts my Nvim configuration for Linux, macOS, and Windows. init.lua is the config entry point for terminal Nvim, and ginit.vim is the additional config file for GUI client of Nvim.

My configurations are heavily documented to make it as clear as possible. While you can clone the whole repository and use it, it is not recommended though. Good configurations are personal. Everyone should have his or her unique config file. You are encouraged to copy from this repo the part you want and add it to your own config.

To reduce the possibility of breakage, this config is only maintained for the latest nvim stable release. No effort is spent on maintaining backward compatibility.

See doc here on how to install Nvim's dependencies, Nvim itself, and how to set up on different platforms (Linux, macOS, and Windows).

• Plugin management via Packer.nvim.
• Code, snippet, word auto-completion via nvim-cmp.
• Language server protocol (LSP) support via nvim-lspconfig.
• Git integration via vim-fugitive.
• Better escaping from insert mode via better-escape.vim.
• Ultra-fast project-wide fuzzy searching via LeaderF.
• Faster code commenting via vim-commentary.
• Faster matching pair insertion and jump via delimitMate.
• Smarter and faster matching pair management (add, replace or delete) via vim-sandwich.
• Fast buffer jump via hop.nvim.
• Powerful snippet insertion via Ultisnips.
• Beautiful statusline via lualine.nvim.
• File tree explorer via nvim-tree.lua.
• Better quickfix list with nvim-bqf.
• Show search index and count with nvim-hlslens.
• Command line auto-completion via wilder.nvim.
• User-defined mapping hint via which-key.nvim.
• Asynchronous code execution via asyncrun.vim.
• Code highlighting via nvim-treesitter.
• Code editing using true nvim inside browser via firenvim.
• Beautiful colorscheme via sainnhe/gruvbox-material and other colorschemes.
• Markdown writing and previewing via vim-markdown and markdown-preview.nvim.
• LaTeX editing and previewing via vimtex ¹.
• Animated GUI style notification via nvim-notify.
• Smooth scroll experience via neoscroll.
• Tags navigation via vista.
• Code formatting via Neoformat.
• Undo management via vim-mundo
• ......

For more UI demos, check here.

Go to a string starting with se

Some of the shortcuts I use frequently are listed here. In the following shortcuts, <leader> represents ASCII character ,.

In addition to commands provided by various plugins, I have also created some custom commands for personal use.

If you find anything that needs improving, do not hesitate to point it out or create a PR.

If you come across an issue, you can first use :checkhealth command provided by nvim to trouble-shoot yourself. Please read carefully the messages provided by health check.

If you still have an issue, open a new issue.

Some of the resources that I find helpful in mastering Nvim is documented here. You may also be interested in my posts on configuring Nvim:

• My nvim notes can be found here
• Using Neovim for Three years
• Config nvim on Linux for Python development
• Nvim config on Windows 10
• Nvim-qt config on Windows 10

1: Not enabled for Linux, you need to tweak lua/plugins.lua and change the condition for installing vimtex.↩