Backends#

The editor stores plain markdown files in content/. The same files can be processed by supported backends to produce a static site. Currently, the only supported backend is Hugo + Book theme.

Hugo + Book Theme#

The SSG layer converts markdown content into a fully static HTML site using Hugo and the Book theme by Alex Shpak (MIT).

Why Hugo#

Hugo is the most popular static site generator — mature, fast (sub-second builds), and distributed as a single binary. No runtime dependencies.

Why Book Theme#

The Hugo Book theme (~4k stars, MIT) is built for documentation:

Clean, minimal, mobile-friendly design
Works without JavaScript
Dark mode, search, multi-language support
Useful shortcodes: hints, tabs, expand/collapse, mermaid diagrams

Supported Formatting#

Feature	Editor	Hugo + Book
CommonMark	✅	✅
GFM (tables, strikethrough, task lists)	✅	✅
Markdown alerts (`> [!NOTE]`)	✅ styled callout	✅ via `book-hint` CSS
Hugo shortcodes (`{{< … >}}`)	🔶 highlighted as badges	✅ full rendering

For unimplemented shortcodes, the raw {{< … >}} syntax is preserved in the markdown source and highlighted as a badge in the editor. The Hugo build processes them correctly.

Dependencies#

inb4doc fetch-deps downloads:

Hugo → ~/.cache/inb4doc/bin/hugo (auto-detected on PATH)
Book theme → ssg/themes/book/

Both are downloaded on first use if missing.

Build#

# Manual Hugo build
cd ssg
hugo --source . \
     --contentDir ../content \
     --themesDir themes \
     --theme book \
     --destination build

# Or via the SSG CLI
inb4doc package

Output: ssg/build/ — a portable static site compatible with GitHub Pages, Netlify, Surge, Vercel, or plain S3.