Build docs like code
Linear documents, rebuilt as modular branching systems.
Turn complex knowledge into clear, maintainable documentation
Docs Assembler is a free VS Code extension that lets you build interactive, branching documentation using modular pieces - just like building with Lego or writing clean code.
Instead of writing long linear documents that quickly become outdated and duplicated, you create small reusable maps that can call each other, nest inside one another, and adapt to the reader's situation.
Why it feels different
- Maps - act like classes or functions - reusable, composable and maintainable.
- Routing - lets one map call another and return (clean branching logic).
- Nesting - lets you hide complexity while keeping everything organised.
- Variables + Ancillaries - eliminate duplication and let readers expand detail when needed.
- Full Git ownership - everything lives in plain JSON + Markdown files in your repositories.
Key Benefits
- Absolute ownership - Your content is in Git. Full history, rollback, offline work. No subscriptions.
- Zero lock-in - Publish to clean, standard Markdown files. Uninstall the extension anytime - your docs still work.
- Easy publishing - Built-in support for GitHub Pages (with Jekyll/Liquid compatibility).
- Team-friendly - Different people or teams can own different maps and remote guides.
- Scalable - Guides with hundreds or thousands of steps remain organised and maintainable.
Get started
- Live Demo - Explore a real published guide.
- Demo Repository - See the source maps.
- Template Repository - Ready-to-use starter with GitHub Pages setup.
- Install from Open VSX.
- Install from VS Code Marketplace.
- .vsix releases on GitHub.
We can't see you - so tell us
Docs Assembler collects
no analytics, usage data, or crash reports.
We cannot see your downloads, your location, or how you use this tool.
The only way we know you're using Docs Assembler is if you tell us :
- Open an issue - bugs or feature requests.
- Start a discussion - questions or ideas.
- team@netoftrees.com - anything else, email us.
- ⭐ Star on GitHub - if you find it useful.
- Follow on X - updates and announcements
Internationalisation by design
Docs Assembler's fragment model is designed for analytic and high-inflection languages alike. English and Chinese authors write plain Markdown. Russian, Arabic, and Polish guides are assembled with full grammatical context at the display layer — no special syntax required. Read the Display Tool Contract for the full architecture.
Built with HAL Robotics
Born from long conversations with HAL Robotics - the kind that change how you see a problem.
Note: Docs Assembler is stable for daily use. We recommend testing thoroughly before deploying mission-critical documentation.
©
