Structured documents, compiled

Write the document.
Verify the rest.

docc is a deterministic compiler for structured Markdown documents. It verifies what a document must contain before it creates the Word file people actually use.

Make a checked letter Markdown in · contract verified · .docx out
~/matter · zsh
$ docc check mahnung.md
checking ch_letter against starter-letter…
✓ structure matches the document type
✓ required values satisfy the schema
✓ letter rules passed

$ docc build mahnung.md
validating before rendering…
✓ mahnung.docx
Why a compiler?

A file that opens is not a document you can trust.

Word will render almost anything. A document compiler makes the requirements explicit, checks them in one pass, and refuses to render a document that breaks its contract.

01 / AUTHOR

Keep the source readable

Draft in Markdown: ordinary paragraphs, headings and lists, with YAML for the facts that belong in a letter.

02 / VERIFY

Make requirements checkable

A schema declares the fields, structure and rules. docc points at every issue with a source location and a useful hint.

03 / BUILD

Keep layout out of prose

A theme owns the stationery, styles and furniture. A valid source builds to a deterministic .docx with that chosen layout.

The whole system

One small pipeline. Clear responsibility at every step.

01 / SOURCEMarkdownReadable prose and frontmatter, in one diffable file.
02 / PARSEStructureHeadings, blocks, spans and fields are understood as document parts.
03 / VERIFYSchemaRequired facts, ordering and document-specific rules are checked together.
04 / EMITTheme → .docxValidated content meets fixed layout, with repeatable output.
The important boundary: docc does not invent content, operate a template editor or hide your prose in a database. It compiles an authored document and gates rendering on validation.
A guide for the work

Start with one letter. Understand the system when you need it.

The practical result

Spend the last five minutes on the letter—not on avoiding document accidents.

Use the editor you already use. Let the compiler check the things a professional document cannot leave to memory.

✓the document type is explicit
✓required facts are present and well-formed
✓the layout comes from the approved profile

Start the letter walkthrough