Neovim Configuration Tutorial for Beginners

This guide will help you get started with this minimal but powerful Neovim configuration designed for everyday coding and text editing.

Quick Start

First Time Setup

1. Install Neovim 0.9.5+

   # Ubuntu/Debian
   sudo apt install neovim
   
   # macOS with Homebrew
   brew install neovim

2. Backup any existing config (optional)

   mv ~/.config/nvim ~/.config/nvim.backup

3. Set up this configuration

   # Place your init.lua file in your config directory
   cp init.lua ~/.config/nvim/

4. Launch Neovim

   nvim

   The plugins will automatically install on first launch.

Essential Features

File Navigation

Essential Vim Basics

Modes to Know:

• Normal mode: Press Esc - for navigation and commands
• Insert mode: Press i - for typing text
• Visual mode: Press v - for selecting text

Basic Movement:

• hjkl - left/down/up/right
• w - jump to next word
• b - jump to previous word
• gg - go to top of file
• G - go to bottom of file
• Ctrl+u/d
  - page up/down

Essential Commands:

• i - enter insert mode at cursor
• a - enter insert mode after cursor
• o - create new line below and enter insert mode
• dd - delete entire line
• yy - copy entire line
• p - paste after cursor
• u - undo
• Ctrl+r
  - redo

Saving and Quitting

Keyboard Shortcuts:

• Ctrl+s
  - Save file (works in any mode)
• jj - Exit insert mode (faster than Esc)

Traditional Vim Commands:

• :w - Save file
• :q - Quit
• :wq - Save and quit
• :q! - Quit without saving

Search Features

Basic Search:

• /pattern - Search forward
• ?pattern - Search backward
• n - Next match
• N - Previous match
• Space+/
  - Clear search highlighting

Window Management

Splitting Windows:

• Ctrl+w+v
  - Vertical split
• Ctrl+w+h
  - Horizontal split
• Ctrl+w+w
  - Switch between windows
• Ctrl+w+q
  - Close current window

New windows open:

• Vertically on the right side
• Horizontally below current window

Visual Features

Appearance:

• Line numbers enabled
• Relative line numbers (helps with jumps)
• Current line highlighted
• Gruvbox color scheme (easy on eyes)
• True colors support

Editing Helpers:

• Mouse support enabled (can click and scroll)
• System clipboard integration
• Smart indentation
• Spaces instead of tabs (4 spaces)

Customization Tips

Adding New Keybindings

Add this pattern to your init.lua:

-- Custom mapping example
vim.keymap.set('n', 'e', ':NERDTreeToggle', { 
  noremap = true, 
  silent = true,
  desc = "Toggle file explorer"
})

Installing New Plugins

Add to plugins section:

require('lazy').setup({
  -- Existing plugins...
  { 'new/plugin-name' },  -- Add new plugin here
})

Changing Colorscheme

Replace this line:

vim.cmd('colorscheme gruvbox')

With your preferred colorscheme name.

Troubleshooting

Plugin Issues

If plugins don't load:

1. Restart Neovim
2. Run :Lazy sync inside Neovim
3. Check for error messages

Performance Tips

• Keep large files open in separate Neovim instances
• Use :qa to quit all windows at once
• Regularly close unused buffers with :bd

Getting Help

• Use :help command_name for built-in help
• Press
  Ctrl+h
  in command mode for command completion
• Check plugin documentation at their GitHub repositories

Daily Workflow Example

1. Open project: nvim . (opens current directory)
2. Find file: Press ff, type filename, press Enter
3. Navigate: Use jk or wb to move around
4. Edit: Press i to type, jj when done
5. Save:
   Ctrl+s
6. Search in project: Press fg, type search term
7. Switch files: Press fb, select buffer
8. Quit: :qa (quit all)

Next Steps

Once you're comfortable with these basics:

1. Learn about marks (m to set, ' to jump)
2. Explore macros (q to record, @ to play)
3. Try out registers (" for copy/paste)
4. Learn advanced search patterns
5. Customize the configuration to your workflow