Das Schreibmodell

Markdown, das etwas bedeutet.

Das Dokument bleibt lesbarer Text. Wo pures Markdown eine wichtige Dokumenttatsache nicht ausdrücken kann, ergänzt docc einen kleinen, erklärten Wortschatz: Frontmatter, semantische Blöcke, Spans und bewusste Felder.

Eine Quelle

Die Datei ist ein Dokument, kein Formular mit Datenbeilage.

Eine docc-Datei ist normales Markdown mit YAML-Frontmatter. Sie lässt sich von oben bis unten lesen, in jedem Texteditor bearbeiten, in einem Diff prüfen und ohne spezielle Vorlagensprache weitergeben.

---
docc: 1
document_type: ch_letter
subject: Mahnung — Rechnung 2026-114
---

Sehr geehrte Frau Muster

Wir vertreten die Muster Handels AG in der oben genannten Angelegenheit.

# Aufforderung

Der Marker ist bewusst. Dateien ohne docc: 1 sind keine docc-Dokumente; READMEs, Notizen oder Dateien anderer Markdown-Werkzeuge werden nicht versehentlich kompiliert.

Dokumenttatsachen

Tatsachen gehören ins Frontmatter, nicht als verdeckte Prosa.

Das Schema des Typs erklärt die erlaubten Schlüssel: Zeichenketten, Zahlen, Booleans, Daten, Enums, Listen und zusammengesetzte Werte wie Absender- und Empfängeradressen.

sent: 2026-08-05
registered: true
sender:
  name: Muster & Partner
  uid: CHE-123.456.789
  postal_code: "5000"
beilagen:
  - Rechnung Nr. 2026-114

Ein Feld kann Pflicht sein, einen Standardwert haben, explizites Null erlauben, einem Muster folgen oder nur bestimmte Werte akzeptieren. So bleibt der Brief ein Brief, während Daten zuverlässig prüfbar sind.

Nicht raten: docc describe <type> zeigt den Vertrag eines unbekannten Dokumenttyps direkt aus dem Compiler.
Normales Markdown

Überschriften, Listen und Absätze bleiben wie gewohnt.

Die meisten Dokumente benötigen im Text keine Sondersyntax. Das Schema ordnet üblichen Markdown-Konstruktionen Theme-Stile zu und kann dort eine Überschriftenhierarchie verlangen, wo Struktur wichtig ist.

# Ausgangslage

Unsere Mandantin stellte Ihnen die Rechnung über CHF 8'400.— zu.

# Aufforderung

1. den Betrag bis zum 31. August 2026 zu überweisen;
2. uns die Zahlung unaufgefordert zu bestätigen.

Ein Brief muss bewusst keine festen Abschnitte haben. Eine Rechtsschrift kann zwingende Überschriften und bedingte Unterabschnitte verlangen. Der Text zeigt die Struktur; das Schema entscheidet, wann ihr Fehlen ein Mangel ist.

Wenn Markdown allein nicht reicht

Semantik markieren, ohne die Formulierung zu verstecken.

Zwei Erweiterungen erfassen Tatsachen, die pures Markdown nicht ausdrückt. Beide bleiben sichtbar und beide existieren nur, wenn das Schema ihre Bedeutung erklärt.

Blöcke: strukturierter Bereich mit Attributen

::: partei {#verkaeufer kind=person role=veraeusserer}
Herr [Max Muster]{.name}, geboren am
[12. April 1975]{.geburtsdatum}, wohnhaft an der
[Musterstrasse 10, 5400 Baden]{.adresse}
:::

Ein Block ist ein Bereich :::name. Attribute haben die Form {#id key=value}; das Schema kann Varianten und die für sie verlangten Spans definieren.

Spans: Inline-Fakt mit Typ

Der Erwerber ist [Max Muster]{.partei ref=verkaeufer}.

Ein Span annotiert sichtbaren Text. Er ersetzt keine Formulierung durch Generierung, sondern lässt das Schema Tatsachen prüfen und erklärte Referenzen auflösen.

Ein Leerfeld kann Inhalt sein

Bewusste Lücken von fehlenden Angaben unterscheiden.

Manche Dokumente müssen eine handschriftlich zu ergänzende Stelle enthalten: Unterschrift, Auswahl oder Ausführungsdatum. Das ist Inhalt in einem bewussten Zustand, nicht ein vergessenes Frontmatter-Feld.

Ort und Datum: [________________]{.docc-field key=before_execution}

Unterschrift: [________________]{.docc-field key=signature}

Der reservierte docc-field-Span markiert den Unterschied. check kann ein beabsichtigtes Leerfeld akzeptieren, während build Felder zurückweisen kann, die vor der endgültigen Ausgabe auszufüllen sind.

Das Modell bleibt geschlossen

Keine zweite Programmiersprache ins Dokument schmuggeln.

docc hält das Inhaltsmodell absichtlich klein: Frontmatter, Blöcke, Spans, Felder, Textstruktur und benannte Regeln. Layout gehört zum Theme. Bedingte Vorlagenlogik, Makros und externe Datenmontage sind keine Schreibfunktionen.

Der Gewinn ist Lesbarkeit: Der Text bleibt ein Dokument, Änderungen sind im Diff sichtbar, und der Compiler erhält trotzdem die Struktur, die für verlässliche Prüfungen nötig ist.

Alle Details stehen im verbindlichen Authoring Guide und in der Schema-Referenz.