The Neovim Book
From First Principles to a Reproducible Professional Workstation.
Coming soon
Neovim taught as a small, observable, programmable runtime. The book starts from a clean nvim process and develops the editing language, the Lua configuration loader, the API, the event loop, Tree-sitter, and the built-in LSP client before any plugin appears. Plugins then enter one by one, each as the answer to a demonstrated gap, each profiled for what it owns and what still works without it. LazyVim comes last, once its underlying machinery is no longer opaque.
Status: the first-edition draft is content-complete (31 chapters, 5 appendices, about 95,000 words). Verification and final editing are underway.
First edition ships DRM-free as PDF and EPUB, with free updates.
From a clean process to a professional workstation.
Native editing craft, the Lua runtime, language tooling without an IDE shell, plugins by demonstrated need, turn-key frameworks, and production practice. Expand a part to see its chapters.
What this book assumes, and how to read it
Part 1 Lineage and Foundations 3 chapters
- 1 From vi to Neovim
- 2 Neovim and Vim
- 3 The Editor as a State Machine
Part 2 Native Editing Craft 6 chapters
- 4 A Clean-room Configuration
- 5 Options, Mappings, Commands, and Autocommands
- 6 Editing as a Composable Language
- 7 Registers, Macros, and Repeatable Work
- 8 Buffers, Windows, Tab Pages, and Lists
- 9 Files, Projects, Sessions, and Native Navigation
Part 3 Lua and the Neovim Runtime 5 chapters
- 10 Lua Configuration as Software
- 11 The API Object Model
- 12 Events, Scheduling, Jobs, and Channels
- 13 Terminal, Headless, Remote, and UI Clients
- 14 Authoring and Testing a Small Plugin
Part 4 Language Tooling Without an IDE Shell 4 chapters
- 15 Trees and Syntax
- 16 The Built-in LSP Client
- 17 Diagnostics, Completion, Snippets, Formatting, and Linting
- 18 Project Toolchains
Part 5 Plugins by Demonstrated Need 7 chapters
- 19 The Plugin System from First Principles
- 20 Dependencies and lazy.nvim
- 21 Interface and Feedback Plugins
- 22 Navigation, Search, Git, and Editing Plugins
- 23 Language-intelligence Plugins
- 24 Domain Workflows
- 25 AI-assisted Editing
Part 6 Turn-key Frameworks 2 chapters
- 26 LazyVim Anatomy
- 27 Operating and Customizing LazyVim
Part 7 Production Practice 4 chapters
- 28 Performance and Startup Engineering
- 29 Security, Trust, and Reproducibility
- 30 Troubleshooting and Recovery
- 31 Capstone: A Minimal Professional Workstation
Part 8 Appendices 5 appendices
- A Migrating Vim Configuration
- B Command, API, Event, and Runtime-path Atlas
- C Pinned Plugin Catalog
- D Sources, Reproducibility, and Verification
- E Glossary and Generated Subject Index
For professionals who already know editing basics.
You can enter and leave Insert mode, move, search, save, and survive :help. The book assumes no Lua expertise, no plugin-manager familiarity, and no knowledge of Neovim internals.
- IT professionals who work across many languages and repositories and want reliable leverage from their editor.
- Engineers who want language tooling without an IDE shell: Tree-sitter, the built-in LSP client, diagnostics, and formatting.
- Operators who need a configuration another person can test, reproduce, and recover.
Coming soon.
The manuscript is written and the book is in production. Send us a short email and you will get one reply when it ships, with a sample chapter as soon as one is public.