YAML vs. TOML

Zwei Philosophien: erschlossen versus deklariert

Der tiefste aller Unterschiede ist, wo die Struktur lebt. In YAML ist Struktur Leerraum: Einrückungsebenen definieren die Verschachtelung, und Tabs sind kategorisch verboten. In TOML ist Struktur Zeichensetzung: Eine Zeile wie [database.pool] deklariert eine Tabelle, und Einrückung ist rein kosmetisch. Alles andere auf dieser Seite – Einfügesicherheit, Ausführlichkeit in der Tiefe, Fehlermeldungen – folgt aus dieser einen Entscheidung.

Syntax: Einrückung gegen Tabellenheader

Flache Konfiguration schmeichelt beiden Formaten; tiefe Verschachtelung trennt sie. YAML wird mit wachsender Struktur immer leiser – zwei Leerzeichen und ein Strich –, während TOML eine Headerzeile pro Ebene schreibt: [database.pool.limits], dann [database.pool.limits.read]. Bei drei Ebenen ist TOML bloß ausführlich; bei acht ist YAML die einzig vernünftige handgeschriebene Wahl. Tabellen-Arrays drehen das Urteil um: TOMLs [[products]]-Blöcke sind knackig und greppbar, während lange YAML-Listen von Maps genau dort sind, wo Spalten abdriften.

Einfügesicherheit folgt unmittelbar. Ein Block, der in YAML eine Spalte zu weit links oder rechts eingefügt wird, bricht entweder das Parsen oder – schlimmer – verändert still seine Bedeutung; die Datei parst weiter, und nichts warnt Sie. In TOML trägt ein eingefügter Block seinen eigenen [Header], landet also dort, wo seine Überschrift es sagt, ganz gleich, wie der umgebende Leerraum aussieht.

Typen und das Norwegen-Problem

YAML erschließt Skalartypen, und die Inferenz hat Zähne: yes, no, on und off werden unter den YAML-1.1-Regeln, die viele Parser noch ausliefern, zu Booleans, NO wird false, und eine als 1.20 geschriebene Version kann als Zahl 1.2 ankommen. YAML 1.2 hat die Regeln gestutzt, aber die Parser nicht vereinheitlicht, sodass dieselbe Datei je nach Tool unterschiedlich typisiert sein kann. Die Verteidigung ist, alles in Anführungszeichen zu setzen, was ein String bleiben muss.

TOML hat keinen Inferenzschritt, den man falsch machen könnte: Anführungszeichen machen einen String, nackte Ziffern machen eine Ganzzahl (Unterstreichzeichen zur besseren Lesbarkeit erlaubt), und RFC 3339-Zeitstempel sind ein erstklassiger Typ – ein echter Vorteil gegenüber JSON wie YAML für Konfiguration, die Datumsangaben enthält. Mehrzeilige Strings gibt es in beiden: TOMLs dreifach zitierte """-Blöcke und YAMLs |- und >-Skalare.

Ökosysteme und wann Sie was wählen

Die Ökosysteme haben das Terrain bereits aufgeteilt. YAML besitzt Cloud-native und CI: Kubernetes-Manifeste, GitHub Actions und GitLab CI, Ansible, docker-compose, OpenAPI-Beschreibungen. TOML besitzt Packaging- und Tooling-Metadaten: Rusts Cargo, Pythons pyproject.toml und eine lange Liste von CLI-Tools, die eindeutige, kommentarfreundliche Konfiguration wollen. Sich gegen ein Ökosystem zu entscheiden bedeutet, für immer gegen dessen Tooling zu kämpfen, daher ist das selten eine freie Wahl.

Wo Sie doch wählen: YAML für tief verschachtelte, von Menschen geprüfte Dokumente, und TOML, wenn Werte eindeutig, Diffs exakt und Dateien von Menschen wie Generatoren bearbeitet sein müssen. Die Empfehlung kehrt sich routinemäßig um – die meisten Repositories haben beide –, und die hier verlinkten Konverter überbrücken beide Richtungen lokal.