living-docs
living-docs guideGuide

Pipeline

Source to HTML, and the zero-judgment draft path

Abstract. ingest accepts a file path (Markdown, plain text, HTML, or PDF), a URL, inline text, or standard input. It returns an outline with section ids, titles, and word counts. Large sources stay bounded: read the outline, then pull one section at a time with --section <n|id>.

The engine turns one source into one self-contained HTML document.

text
source -> ingest -> outline + normalized blocks
                 |
                 +-> --draft -> valid document model
                 |
                 +-> author a richer model against the schema
                                      |
                                render --theme -> single HTML file

1 Ingest

2 Draft models

ingest --draft is the zero-judgment path. It writes a document model that validates and renders immediately. An author then adds figures, charts, callouts, stats, and console panels against the schema.

3 Render

render validates the model, resolves style tokens, and writes one file with inline CSS, inline SVG, and the console runtime. The file loads no fonts, images, or scripts from the network.

4 See also