JSON zu TOML Konverter

TOML steht für Tom's Obvious, Minimal Language und ist ein Format für Konfigurationsdateien, das sich leicht lesen und schreiben lässt. Du brauchst eine Umwandlung von JSON nach TOML meist dann, wenn du Daten aus einer API oder einer bestehenden JSON-Datei in eine Konfiguration übernehmen möchtest. Bekannte Beispiele sind die Cargo.toml von Rust, die pyproject.toml von Python-Projekten oder die Konfiguration des Hugo-Generators.

Der wichtigste strukturelle Unterschied liegt in der Darstellung. JSON nutzt geschweifte Klammern und Doppelpunkte, während TOML mit Abschnitten in eckigen Klammern und einfachen schlüssel = wert-Zeilen arbeitet. Ein JSON-Objekt wird dabei zu einer TOML-Tabelle, ein verschachteltes Objekt zu einer Untertabelle.

TOML legt mehr Wert auf Lesbarkeit für Menschen, JSON eher auf den Austausch zwischen Maschinen. Beide beschreiben dieselbe Baumstruktur aus Schlüsseln, Werten, Listen und verschachtelten Objekten, nur mit anderer Syntax. Wer den Aufbau einmal verstanden hat, erkennt die direkte Entsprechung zwischen den Formaten sofort wieder.

Der Ablauf besteht aus drei Schritten. Zuerst wird dein JSON-Eingabetext eingelesen und auf gültige Syntax geprüft. Ein fehlendes Komma oder eine offene Klammer führt zu einer klaren Fehlermeldung, sodass du die Stelle schnell findest.

Im zweiten Schritt wird die geprüfte Struktur auf die TOML-Syntax abgebildet. Objekte werden zu Tabellen, deren Pfad in eckigen Klammern steht, etwa [server.database]. Einfache Werte landen als schlüssel = wert-Zeilen, Listen werden zu Arrays.

Mehrere Sonderfälle werden dabei berücksichtigt:

Zum Schluss wird das fertige TOML formatiert ausgegeben. Du kannst das Ergebnis kopieren und direkt in deine Konfigurationsdatei einfügen. Die gesamte Verarbeitung läuft im Browser, deine Daten verlassen dein Gerät nicht. Wenn du nur die Eingabe vorab säubern möchtest, hilft der JSON Formatter.

Die Umwandlung von JSON nach TOML kommt überall dort vor, wo Konfigurationen lesbar bleiben sollen. Drei Bereiche tauchen besonders häufig auf.

Beim Aufbau von Projektdateien erzeugst du aus einer JSON-Vorlage eine Cargo.toml oder eine pyproject.toml. So lassen sich Abhängigkeiten, Metadaten und Build-Einstellungen aus einem maschinell erzeugten Format in eine gepflegte Konfiguration überführen.

Bei der Migration von Konfigurationen wechselst du ein bestehendes Setup von JSON auf TOML, etwa weil ein neues Werkzeug TOML erwartet. Der Konverter übernimmt dabei die Struktur eins zu eins und du musst nichts von Hand abtippen.

Beim Austausch zwischen Systemen liefert eine API ihre Antwort als JSON, das Zielsystem liest aber TOML. Hier dient die Umwandlung als Brücke zwischen beiden Welten.

Für den umgekehrten Weg steht der TOML zu JSON Konverter bereit, und wer stattdessen YAML benötigt, nutzt den JSON zu YAML Konverter.

Ein kurzes Beispiel zeigt die Entsprechung am besten. Dieselbe Konfiguration sieht in JSON kompakt, in TOML dagegen sehr lesbar aus.

In JSON:

`` { "server": { "host": "localhost", "port": 8080 } } ``

In TOML:

`` [server] host = "localhost" port = 8080 ``

Beide beschreiben denselben Inhalt. TOML verzichtet auf Klammern und Anführungszeichen bei Schlüsseln und nutzt stattdessen Abschnitte und Zeilen. Das macht die Datei für Menschen angenehmer zu lesen, vor allem bei vielen Werten.

Ein weiterer Unterschied betrifft Datentypen. TOML kennt native Datums- und Zeitwerte sowie mehrzeilige Zeichenketten, die in JSON umständlicher zu schreiben sind. Listen von Objekten werden in TOML als Tabellen-Arrays dargestellt, was bei wiederkehrenden Blöcken übersichtlich bleibt. Wenn du die Unterschiede einmal verinnerlicht hast, wählst du je nach Werkzeug das passende Format und nutzt den Konverter als schnelle Brücke dazwischen.

Die meisten Umwandlungen verlaufen verlustfrei, weil JSON und TOML dieselbe Baumstruktur abbilden können. Zeichenketten, Zahlen, Wahrheitswerte, Listen und verschachtelte Objekte gehen sauber von einem Format ins andere über.

An einigen Stellen lohnt ein genauer Blick. JSON kennt den Wert null, TOML dagegen nicht. Solche Felder müssen daher weggelassen oder durch einen Platzhalter ersetzt werden. Auch sehr große Ganzzahlen und besondere Gleitkommawerte sollten geprüft werden, damit ihre Genauigkeit erhalten bleibt.

Bei den Schlüsseln gibt es eine Feinheit. Enthält ein JSON-Schlüssel Leerzeichen oder Sonderzeichen, setzt TOML ihn in Anführungszeichen. Der Konverter erledigt das automatisch, sodass die Ausgabe immer gültig bleibt.

Datumstexte im ISO-Format werden nach Möglichkeit als native TOML-Datumswerte ausgegeben. Wenn du sichergehen möchtest, dass nichts verloren geht, wandle das Ergebnis mit dem TOML zu JSON Konverter zurück und vergleiche beide Stände. Stimmen sie überein, war die Umwandlung in beide Richtungen vollständig.