Kurz gesagt
JSON, YAML und Markdown sind drei Klartext-Formate, denen du beim Bauen ständig begegnest. JSON und YAML speichern beide strukturierte Daten wie Einstellungen und Listen, während Markdown für formatierten Text wie Dokumentation und Notizen da ist. Keines davon ist eine Programmiersprache; es sind nur vereinbarte Arten, Informationen so zu schreiben, dass sowohl Menschen als auch Programme sie lesen können. Sobald du die drei erkennst, hören die meisten Config-Dateien auf, beängstigend auszusehen.
JSON: Daten für Maschinen
JSON (JavaScript Object Notation) speichert Daten als Schlüssel-Wert-Paare, mit geschweiften Klammern und Anführungszeichen. Es ist überall: API-Antworten, Paket-Dateien, App-Einstellungen. Es ist streng, also bricht ein einziges fehlendes Komma oder Anführungszeichen es.
{
"name": "my-app",
"version": "1.0.0",
"private": true
}YAML: Daten für Menschen
YAML speichert dieselbe Art Daten wie JSON, nutzt aber Einrückung statt Klammern, was es leichter von Hand lesbar und schreibbar macht. Es ist üblich in Workflow- und Deploy-Config. Der Haken: Abstände zählen. YAML nutzt Leerzeichen zur Einrückung, niemals Tabs.
name: my-app
version: 1.0.0
private: trueMarkdown: formatiertes Schreiben
Markdown ist für Text, nicht für Daten. Du fügst einfache Symbole zu Klartext hinzu, um Überschriften, Fettdruck, Listen und Links zu markieren, und es wird als schön formatierter Inhalt dargestellt. Diese Seite, die meisten READMEs und KI-Anweisungsdateien wie CLAUDE.md sind alle Markdown.
# Eine Überschrift
Etwas **fetter** Text und eine Liste:
- erster Eintrag
- zweiter EintragWie du sie auseinanderhältst
Eine schnelle Faustregel klärt die meiste Verwirrung. Wenn du geschweifte Klammern und viele Anführungszeichen siehst, ist es JSON. Wenn du saubere Einrückung mit Doppelpunkten und ohne Klammern siehst, ist es YAML. Wenn du "#"-Überschriften und "-"-Bullets siehst, die für einen Menschen gedacht sind, ist es Markdown. Du musst keines davon perfekt von Hand schreiben, weil dein KI Agent diese Dateien für dich erzeugt und bearbeitet. Es hilft, zu erkennen, was was ist, damit du, wenn ein Tool nach "einer YAML-Config" oder "einer JSON-Datei" fragt, weisst, was es erwartet, und einen offensichtlichen Fehler auf einen Blick siehst.