Build docs like code
From linear documents to modular, branching systems in VS Code.
Turn complex knowledge into clear, maintainable documentation
Docs Assembler is a free VS Code extension by netoftrees 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.
Feedback
We don't collect analytics or track usage. We only know you're using Docs Assembler if you tell us.
- Issues: GitHub Issues.
- Discussions: GitHub Discussions.
- Email: team@netoftrees.com.
- X: @docsassembler.
Built with HAL Robotics
Born from long conversations with HAL Robotics - the kind that change how you see a problem.
Note: This is an early version of Docs Assembler. It is stable for most uses, but we recommend testing thoroughly for mission-critical documentation. A more mature release is planned later in 2026.