Learn Vim (the Smart Way) is a structured learning guide that teaches Vim and Vimscript fundamentals through progressive chapters covering both basic and advanced topics.
The guide addresses the gap between Vim's built-in tutorial and its comprehensive help manual. Rather than overwhelming learners with all available features, it focuses on the most useful parts of Vim, organizing content from broad foundational concepts to specific advanced techniques. The material spans core editing operations like movement, insertion, and visual mode; intermediate features such as registers, macros, and the global command; customization through vimrc and packages; and Vimscript programming for plugin development.
The guide suits anyone learning Vim from scratch through intermediate proficiency, whether they prefer reading online or locally via Docker. It explicitly positions itself as an alternative to relying solely on vimtutor for initial learning or the help manual for reference, offering a middle path that prioritizes practical knowledge over exhaustive documentation. The content is free and available online, with optional paid versions available through other channels.
The project maintains a stable, curated collection of learning material organized into three major parts covering usage, customization, and scripting. Updates are announced through dedicated social channels, indicating ongoing engagement with the learning community.