Neovim Quick Learning Guide

1. Installation & Setup ✓

Task 1.1: Install Neovim

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install neovim

macOS:

brew install neovim

Windows:

winget install Neovim.Neovim
# or download from: https://github.com/neovim/neovim/releases

Task 1.2: Verify Installation

nvim --version

You should see version info and build details.

Task 1.3: Basic Configuration

Create config file:

# Linux/Mac
mkdir -p ~/.config/nvim
nvim ~/.config/nvim/init.lua
 
# Windows
mkdir %USERPROFILE%\AppData\Local\nvim
nvim %USERPROFILE%\AppData\Local\nvim\init.lua

Minimal init.lua:

-- Basic settings
vim.opt.number = true
vim.opt.expandtab = true
vim.opt.tabstop = 4
vim.opt.shiftwidth = 4
vim.opt.hlsearch = true
vim.opt.ignorecase = true
vim.opt.smartcase = true
 
-- Enable syntax highlighting
vim.cmd('syntax on')

Practice: Run nvim and verify line numbers appear.

---

2. Understanding Modes ✓

Task 2.1: Normal Mode Basics

• Start here: Normal mode is the default
• Purpose: Navigate and execute commands
• Key point: Press Esc to return to Normal mode from any other mode

Task 2.2: Enter Insert Mode

Key	Action
i	Insert before cursor
a	Insert after cursor
o	Insert new line below
O	Insert new line above
I	Insert at beginning of line
A	Insert at end of line

Task 2.3: Visual Mode Selection

Key	Action
v	Character-wise selection
V	Line-wise selection
Ctrl+v	Block selection

Task 2.4: Mode Switching Practice

Exercise:

1. Start in Normal mode
2. Press i → type “Hello” → press Esc
3. Press o → type “World” → press Esc
4. Press V → select the line → press Esc
5. Repeat until switching feels natural

Practice: Set a timer for 20 minutes and practice mode switching.

---

3. Basic Commands ✓

Task 3.1: Quit Neovim

Command	Action
:q	Quit (if no changes)
:q!	Quit without saving
:wq	Save and quit
ZZ	Save and quit (shortcut)
ZQ	Quit without saving (shortcut)

Task 3.2: Open Files

:e filename.txt     " Edit file
:e .               " Open current directory
:e ~/Documents/    " Open specific directory

Task 3.3: Save Files

:w                 " Save current file
:w filename.txt    " Save as filename.txt
:wa                " Save all open files

Task 3.4: Help System

:h                 " General help
:h :w              " Help for :w command
:h i               " Help for 'i' key
:h modes           " Help about modes

Task 3.5: Navigate Help

1. Open help: :h
2. Find a topic with |pipes| around it (like |quickref|)
3. Put cursor on it and press Ctrl+] to jump
4. Press Ctrl+o to go back
5. Try several topics to practice

---

Quick Practice Exercises

Exercise 1: File Operations (5 minutes)

1. Create new file: nvim practice.txt
2. Enter Insert mode: i
3. Type: “This is my first Neovim file”
4. Exit Insert mode: Esc
5. Save: :w
6. Quit: :q

Exercise 2: Mode Practice (10 minutes)

1. Open file: nvim practice.txt
2. Practice each insert mode:
   • i to insert
   • a to append
   • o for new line
3. Practice Visual mode:
   • v to select characters
   • V to select lines
4. Always return to Normal mode with Esc

Exercise 3: Help Navigation (5 minutes)

1. Open help: :h
2. Navigate to |usr_02.txt| with cursor
3. Press Ctrl+]
4. Find another link and jump to it
5. Use Ctrl+o to navigate back
6. Close help: :q

---

Success Checklist

After completing these tasks, you should be able to:

• Start and quit Neovim confidently
• Switch between Normal, Insert, and Visual modes
• Open, edit, and save files
• Navigate the help system
• Feel comfortable with basic Neovim operations

---

Next Steps

Once you’ve mastered these basics:

1. Learn basic navigation (hjkl, w, b, 0, $)
2. Practice text editing commands (d, y, p)
3. Explore more insert mode variations
4. Learn search and replace
5. Configure plugins and advanced settings

Remember: Consistency beats intensity. Practice 15-20 minutes daily rather than cramming for hours.