TOML in JSON umwandeln: So ändert sich die Syntax

VeröffentlichtToolTOML ↔ JSON umwandeln

Inhalt
  1. Die Konfiguration liegt als TOML vor, das Tool akzeptiert aber nur JSON
  2. Syntax ohne Tool Schritt für Schritt zuordnen
  3. Typische Stolperstellen beim Lesen des Ergebnisses
  4. Zusammenfassung
  5. Häufige Fragen

Wer TOML in JSON umwandeln möchte, scheitert selten an der Rechenarbeit. Meist fehlt schlicht die Zuordnung im Kopf: Welche Syntax wird zu welcher Struktur? Vorab die Kurzfassung: Die Zuordnung ist einfach. [table] wird zu einem verschachtelten Objekt, [[table]] zu einem Array von Objekten, und Schlüssel mit Punkt (.) sowie Inline-Tabellen { } werden jeweils zu Objekten.

Dieser Beitrag richtet sich an alle, die Konfigurationsdateien zwischen TOML und JSON übertragen. Anhand von Ein- und Ausgaben sehen Sie, was jedes Syntaxelement tatsächlich ergibt.

Zusammenfassung ① [table] wird zu einem verschachtelten Objekt, [[table]] zu einem Array von Objekten, Schlüssel mit Punkt (.) und Inline-Tabellen { } werden jeweils zu Objekten. ② In der Gegenrichtung (JSON → TOML) muss die oberste Ebene unbedingt ein Objekt sein, und Schlüssel mit dem Wert null verschwinden komplett, weil TOML kein null kennt. ③ Werte, die wie ein Datum aussehen, bleiben Strings, und Zahlen mit Unterstrichen wie 1_000_000 werden zu 1000000, also ohne Unterstriche.

Die Konfiguration liegt als TOML vor, das Tool akzeptiert aber nur JSON

TOML ist als Format für Konfigurationsdateien weit verbreitet. Typische Beispiele sind die Cargo.toml in Rust, die pyproject.toml in Python und die config.toml vieler Generatoren für statische Websites.

Probleme entstehen, wenn Sie eine solche Konfiguration an ein anderes Tool oder Skript weitergeben müssen, das nur JSON annimmt. Zum Beispiel, wenn Sie einen Teil der pyproject.toml in ein JSON-basiertes Validierungstool geben wollen oder wenn Sie eine bisher als JSON gepflegte Konfiguration in ein Tool übernehmen, das TOML verwendet.

Beim manuellen Übertragen verrutscht die Struktur leicht: Bis wohin gehört eine verschachtelte Tabelle wie [tool.black] zu einem Objekt? Ist eine doppelte eckige Klammer wie bei [[tool.poetry.source]] ein Array oder ein Objekt? Das Format selbst ist simpel, aber ohne die Zuordnungsregeln passieren genau hier Fehler.

Syntax ohne Tool Schritt für Schritt zuordnen

Zuerst das Prinzip: TOML wurde von Anfang an so entworfen, dass es eindeutig auf eine Hashtabelle (eine Sammlung von Schlüssel-Wert-Paaren, also ein Dictionary) abgebildet werden kann. Deshalb passt es gut zu JSON-Objekten, und die Zuordnung lässt sich in wenigen Regeln zusammenfassen.

Es sind fünf Regeln:

  • Schlüssel = Wert → wird unverändert als Paar "Schlüssel": Wert übernommen.
  • Zeilen unter [owner] → werden zu einem verschachtelten Objekt "owner": { ... } zusammengefasst.
  • Schlüssel mit Punkt (.) wie owner.name = "Max Mustermann" → ergeben genau dasselbe wie die Schreibweise mit [owner], nämlich "owner": { "name": "Max Mustermann" }.
  • Wiederholtes [[posts]] → ergibt ein Array von Objekten: "posts": [ {...}, {...} ]. Die doppelte eckige Klammer ist das Signal für ein „Array“.
  • Inline-Tabelle { x = 1, y = 2 } → wird zum Objekt { "x": 1, "y": 2 }.

Das folgende TOML zum Beispiel

title = "Blog-Einstellungen"
version = 2
tags = ["seo", "auto", "blog"]

[database]
host = "127.0.0.1"
port = 5432

[[posts]]
title = "Erster Beitrag"
views = 120

[[posts]]
title = "Zweiter Beitrag"
views = 45

wird so umgewandelt:

{
  "title": "Blog-Einstellungen",
  "version": 2,
  "tags": [
    "seo",
    "auto",
    "blog"
  ],
  "database": {
    "host": "127.0.0.1",
    "port": 5432
  },
  "posts": [
    {
      "title": "Erster Beitrag",
      "views": 120
    },
    {
      "title": "Zweiter Beitrag",
      "views": 45
    }
  ]
}

Man sieht auf einen Blick, dass [database] zum Objekt "database" und [[posts]] zum Array "posts" wurde.

Wenn Sie prüfen möchten, ob Ihr manuell übertragenes Ergebnis stimmt, können Sie es durch einen Standard-Parser laufen lassen. Ab Python 3.11 enthält die Standardbibliothek mit tomllib einen TOML-Parser, der nur lesen kann. Ohne zusätzliche Installation sehen Sie dieselbe Umwandlung mit einer einzigen Zeile:

python3 -c "import tomllib,json; print(json.dumps(tomllib.load(open('config.toml','rb')), indent=2, ensure_ascii=False))"

Der Vorteil: Es ist ein vollwertiger Parser und meldet daher Syntaxfehler als Fehler. Allerdings ist es jedes Mal umständlich, erst eine Datei anzulegen und dann den Befehl einzutippen. Für die Gegenrichtung (JSON → TOML) bietet die Standardbibliothek zudem kein Schreibwerkzeug, sodass Sie eine zusätzliche Bibliothek installieren müssen.

Mit unserem Tool prüfen.

TOML ↔ JSON umwandeln

Einfügen und direkt im Browser in beide Richtungen zwischen TOML und JSON umwandeln. Kostenlos, ohne Installation und Registrierung; Ihre Eingaben werden nicht an einen Server gesendet.

Typische Stolperstellen beim Lesen des Ergebnisses

Wenn Sie die Zuordnung kennen, gibt es bei der Richtung TOML → JSON kaum Missverständnisse. Unklarheiten entstehen vor allem in der Gegenrichtung und bei einigen Werten. Die häufigsten Fälle im Überblick:

SituationErgebnis
JSON-Wurzel ist ein Array, eine Zahl oder ein StringFehler „Die oberste Ebene von TOML muss ein Objekt sein“
Schlüssel mit dem Wert nullDer Schlüssel entfällt komplett, da TOML kein null kennt
Datumsstring wie "2026-07-17"Bleibt ein String in Anführungszeichen
Zahl mit Unterstrichen wie 1_000_000Wird zur Zahl 1000000 ohne Unterstriche
# Kommentar (außerhalb von Anführungszeichen)Wird im Ergebnis entfernt

Die oberste Ebene muss ein Objekt sein. In der Richtung JSON → TOML meldet der Konverter „Die oberste Ebene von TOML muss ein Objekt sein“, wenn die oberste Ebene wie bei [1, 2, 3] ein Array oder einfach nur eine Zahl bzw. ein String ist. Eine TOML-Datei ist insgesamt eine einzige Sammlung von Schlüssel-Wert-Paaren, daher kann ein namenloses Array nicht ganz außen stehen. Wenn Sie es wie in { "items": [1, 2, 3] } einmal in einen Schlüssel einpacken, funktioniert die Umwandlung.

Schlüssel mit null verschwinden. TOML kennt den Wert null überhaupt nicht. Steht in Ihrem JSON "nickname": null, taucht im TOML-Ergebnis die Zeile nickname gar nicht erst auf. Es wird also nicht ein leerer Wert ausgegeben, sondern der ganze Schlüssel entfällt. Wandeln Sie das Ergebnis wieder in JSON zurück, fehlt dieser Schlüssel.

Auch was wie ein Datum aussieht, ist ein String. TOML hat zwar ursprünglich eigene Datums- und Zeittypen, dieser Konverter vereinfacht das aber und speichert Werte wie 2026-07-17 als String statt als Datumstyp. Deshalb steht im JSON-Ergebnis "2026-07-17" in Anführungszeichen. Dass ein solcher Wert fälschlich als Zahl erkannt und dadurch beschädigt wird, passiert nicht.

Unterstriche in Zahlen dienen der Gliederung. In TOML können Sie Ziffern wie in 1_000_000 mit Unterstrichen gliedern, damit sie leichter lesbar sind. Der Konverter entfernt die Unterstriche und macht daraus die Zahl 1000000. Da JSON keine Schreibweise mit Unterstrichen kennt, ist das ein naheliegendes Ergebnis.

Zusammenfassung

  • [table] wird zu einem verschachtelten Objekt, [[table]] zu einem Array von Objekten, Schlüssel mit Punkt (.) und Inline-Tabellen { } werden jeweils zu Objekten.
  • Bei JSON → TOML muss die oberste Ebene ein Objekt sein; wer nur ein Array oder eine Zahl übergibt, erhält einen Fehler.
  • Schlüssel mit dem Wert null entfallen im Ergebnis komplett, da TOML kein null kennt.
  • Werte, die wie ein Datum aussehen, bleiben Strings, und Zahlen mit Unterstrichen wie 1_000_000 werden zu Zahlen ohne Unterstriche.
  • Ein manuell übertragenes Ergebnis lässt sich mit einem Standard-Parser wie Pythons tomllib noch einmal gegenprüfen.
TOML ↔ JSON umwandeln

Einfügen und direkt im Browser in beide Richtungen zwischen TOML und JSON umwandeln. Kostenlos, ohne Installation und Registrierung; Ihre Eingaben werden nicht an einen Server gesendet.

Häufige Fragen

Was wird aus den doppelten eckigen Klammern [[ ]] in TOML in JSON?

Wenn ein [[posts]]-Block mit demselben Namen mehrfach vorkommt, entsteht daraus ein Array von Objekten unter diesem Namen, also "posts": [ { ... }, { ... } ]. Sie müssen nur unterscheiden: Eine einfache Klammer wie in [posts] ergibt ein einzelnes verschachteltes Objekt, doppelte Klammern wie in [[posts]] ergeben ein Array.

Beim Umwandeln von JSON in TOML erscheint eine Fehlermeldung. Woran liegt das?

Das passiert, wenn die oberste Ebene des JSON kein Objekt ist. Besteht die Eingabe aus einem Array wie [1, 2, 3] oder nur aus einer einzelnen Zahl oder Zeichenkette, erscheint die Fehlermeldung „Die oberste Ebene von TOML muss ein Objekt sein“. Eine TOML-Datei besteht insgesamt aus Schlüssel-Wert-Paaren. Wenn Sie die Daten wie in { "items": [1, 2, 3] } einmal in einen Schlüssel einpacken, lässt sich das JSON umwandeln.

Ich habe ein Datum eingegeben, und es erscheint als Zeichenkette in Anführungszeichen.

Das ist normal. Der Konverter behandelt Datum und Uhrzeit vereinfacht als Zeichenkette, daher wird aus 2026-07-17 der Wert "2026-07-17". Der Wert wird dabei weder verändert noch beschädigt, lediglich der Typ bleibt eine Zeichenkette.

Werden meine eingegebenen Einstellungen an einen Server gesendet?

Nein. Alle Umwandlungen laufen direkt in Ihrem Browser ab. Das eingegebene TOML und JSON wird weder an einen Server gesendet noch gespeichert.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. TOTP-Code berechnen: So entsteht der 6-stellige EinmalcodeSo berechnet sich der 6-stellige TOTP-Code: Base32-Schlüssel, 30-Sekunden-Zähler und HMAC-SHA1, otpauth-QR-Code und Gründe, warum der Code nicht passt.
  2. Unicode-Escape umwandeln: \uXXXX, U+ und HTML-EntitätenSo wandeln Sie Zeichen wie Umlaute, Hangul oder Emojis in \uXXXX, U+-Codepoints und HTML-Entitäten um und zurück. Mit Beispielen und Unterschieden.
  3. URL normalisieren: UTM-Parameter entfernen, Standard-URL erhaltenSo entfernen Sie utm_, fbclid, gclid und ref aus Links und bringen URLs in eine Standardform. Dazu: Regeln der Normalisierung und die Ergebnisanzeige.
  4. URL kodieren: Warum Leerzeichen und Umlaute zu %20 werdenWarum wird aus einem Leerzeichen %20 und aus „ä“ %C3%A4? Prozentkodierung, UTF-8-Bytes, encodeURI und encodeURIComponent sowie Doppelkodierung im Beispiel.
  5. URL-Pfadsegmente auslesen und in Routen umwandelnSo zerlegen Sie eine URL in Protokoll, Host, Pfadsegmente und Query und wandeln Segmente in Express-:variable oder Next.js-[variable] um – mit Beispielen.
  6. URL-Kodierung erklärt: Prozentkodierung und kaputte UmlauteWarum Leerzeichen und Umlaute in URLs nicht direkt stehen dürfen, wie Prozentkodierung funktioniert und worin sich encodeURI und encodeURIComponent unterscheiden.

Passende Tools