Docmd

Scaffolds a docs site from a directory of Markdown, rendered through a Handlebars-compatible template engine written from scratch in Go.

Documentation generators tend to arrive with a theme system you have to learn and cannot easily leave. The templating is the part you actually want control over, and it is usually the part that is least yours.

1. 1

   The template engine is the project's own: a lexer, parser and AST that compile a template once into a function you can call repeatedly, rather than re-interpreting it per render.

2. 2

   Handlebars-compatible on purpose. If/else, unless, each with index, with, nested paths, partials, comments, subexpressions and custom helpers all work, so the syntax is already familiar and nothing new has to be learned.

3. 3

   Built for repeated rendering: pooled builders and contexts, a struct field cache instead of repeated reflection, and an HTML escape that only allocates when something actually needs escaping.

• `docmd new` scaffolds a starter project with an embedded skeleton
• Template engine covered by tests for every block type and helper
• Installs via a one-line script
• Written in Go, no runtime dependencies

• Go
• Templating