Documentation & Diagrams Reference

Markup languages, site generators, diagram tools, and math notation. The toolchain behind the documentation system.

Markup & Publishing

Topic Description

AsciiDoc

Markup language — sections, blocks, tables, includes, cross-references

Antora

Site generator — components, playbook, navigation, attributes, builds

Markdown

GFM syntax — README files, GitHub issues, Claude Code config

LaTeX

Math notation — STEM in AsciiDoc, equations, Greek letters, matrices

Diagrams as Code

Topic Description

Diagrams as Code

Tool comparison — when to use D2 vs Mermaid vs GraphViz vs PlantUML

D2

Declarative diagrams — shapes, containers, sequences, Catppuccin theming

Mermaid

Flowcharts, sequences, Gantt, state, class, ER diagrams

GraphViz

Dot language — directed graphs, clusters, ranking, layout engines

PlantUML

UML — sequence, class, component, activity, state, deployment

Kroki

Unified rendering server — Antora integration, container lifecycle