Was dieses Werkzeug tut
Verschachtelte Zuordnungen werden Tabellen, Listen von Zuordnungen werden Arrays von Tabellen:
db:
host: db.example.com
pool:
size: 10
servers:
- name: a
- name: b
[db]
host = "db.example.com"
[db.pool]
size = 10
[[servers]]
name = "a"
[[servers]]
name = "b"
Drei Dinge, die TOML nicht fassen kann
Null. TOML hat keinen Nullwert. Den Schlüssel zu streichen änderte die Aussage der Datei; "" zu schreiben erfände einen Wert. Die Umwandlung hält an und sagt Ihnen, welcher.
Eine Liste an der Wurzel. Eine TOML-Datei ist eine Tabelle: die oberste Ebene sind Schlüssel/Wert-Paare, immer. Ein YAML-Dokument mit einer Sequenz als Wurzel hat keinen Ort dafür. Benennen Sie die Liste, dann geht es.
Mehrere Dokumente. --- trennt YAML-Dokumente; TOML hat keinen Trenner und keine Art zu sagen „und hier ist noch eine Datei“. Eines nach dem anderen.
Daten bleiben Zeichenketten
2026-01-01 kommt als Zeichenkette an, weil YAML 1.2 es so liest, und geht als zitierte Zeichenkette hinaus.
TOML hat durchaus einen eigenen Datumstyp, und ihn zu nutzen hieße zu entscheiden, dass der Autor ein Datum meinte. Manchmal stimmt das. Manchmal ist 2026-01-01 eine Produktreferenz, ein Ordnername, eine Version. Falsch geraten macht aus Text einen Zeitstempel — eine Änderung, die niemandem auffällt, bis weiter hinten etwas zu sortieren beginnt.
Eines zu langen Ganzzahlen
Eine Ganzzahl jenseits von etwa fünfzehn Stellen wird unterwegs gerundet. Die Umwandlung führt über JSON, dessen Zahlen Gleitkommazahlen doppelter Genauigkeit sind, und dort gehen die Ziffern verloren.
yaml-to-json selbst hält sie exakt — es liest die Ziffern, wie sie geschrieben stehen. Die rundende Grenze ist die, die alle json-to-…-Umwandlungen teilen, und sie wird dort behandelt statt hier überklebt. Bis dahin: trägt Ihre Datei einen zwanzigstelligen Bezeichner, setzen Sie ihn im YAML in Anführungszeichen, dann kommt er als Zeichenkette unversehrt hinüber.
Datenschutz ab Werk
Alles läuft lokal in deinem Browser mit JavaScript. Deine Daten werden nie hochgeladen, wodurch das Tool auch für sensible Inhalte sicher ist und offline funktioniert.