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.
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.
docc describe <type> zeigt den Vertrag eines unbekannten Dokumenttyps direkt aus dem Compiler.Ü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.
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.
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.
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.
Alle Details stehen im verbindlichen Authoring Guide und in der Schema-Referenz.