Authoring diagrams and scenes

The handbook supports diagrams and animated scenes directly in Markdown. Authors can stay in prose-first .md and .mdx files without importing React components for every visual.

Mermaid diagrams

Use a fenced mermaid block for flowcharts, sequence diagrams, and other static diagrams.

Elucim scenes

Use a fenced elucim block for YAML-authored scenes. YAML is the default authoring format because it keeps scenes readable inside chapters.

Loading Elucim scene...

If the scene YAML is invalid, the page renders a visible error card with the parser message and the original scene source so the author can fix it in place.