About

JSON zu TOML Konverter

Fügen Sie ein JSON-Objekt links ein, erhalten Sie TOML rechts. Strikte Spezifikationskonformität über @iarna/toml. Kein Upload.

  1. Fügen Sie ein JSON-Objekt in den linken Textbereich ein.
  2. Klicken Sie auf „In TOML umwandeln". Die oberste Ebene muss ein JSON-Objekt sein — kein Array.
  3. Kopieren oder laden Sie die TOML-Ausgabe herunter.
  4. Für Listen von Datensätzen, verwenden Sie ein TOML-Array von Tabellen — verpacken Sie zuerst mit `{ items: [...] }`.
Was macht es?

Konvertiert ein JSON-Objekt über @iarna/toml in ein TOML-1.0-konformes Dokument. Verschachtelte Objekte werden zu `[section]`-Headern; Arrays von Objekten werden zu `[[items]]`-Array-of-Tables-Blöcken; Strings, Zahlen, Booleans und ISO-8601-Datetime-Strings mappen auf TOML-Primitive. Die Ausgabe wird in eine kanonische Reihenfolge sortiert — Schlüssel erscheinen vor Untertabellen für Kompatibilität mit strengen TOML-Parsern.

Beispiel

JSON-Eingabe:

{
  "name": "Ada",
  "active": true,
  "address": {
    "city": "London"
  }
}

TOML-Ausgabe:

name = "Ada"
active = true

[address]
city = "London"

Häufige JSON-zu-TOML-Stolperfallen

TOML hat strengere Top-Level-Regeln als JSON. Die folgenden Muster erklären, warum ein JSON-Wert, der „funktionieren sollte", scheitern kann.

  • Top-Level-Array. TOML kann ein Top-Level-JSON-Array nicht repräsentieren. Verpacken Sie es: `{"items": [...]}`. Das Ergebnis wird zu einem TOML-Array-of-Tables unter `[[items]]`.
  • Top-Level-Skalar. Ein bares `42` oder `"hello"` JSON-Dokument hat keinen Schlüssel, an den es sich in TOML anheften kann. Verpacken Sie es in einem Objekt: `{"value": 42}`.
  • null-Werte. TOML hat keinen null-Typ. Der Serializer lässt Schlüssel mit JSON-Wert null vollständig aus. Wenn Sie „explizit nichts" repräsentieren müssen, verwenden Sie einen leeren String `""` oder einen Sentinel-Wert, je nach nachgelagertem Code.
  • Arrays mit gemischten Typen. TOML 1.0 erlaubt `[1, "two"]`, aber Legacy-0.5-Parser nicht. Wenn Ihr TOML durch 0.5-Tooling Round-Trip muss, halten Sie Arrays homogen im JSON vor der Konvertierung.
  • Schlüssel mit Punkten in der TOML-Ausgabe. Ein JSON-Schlüssel wie `"my.key"` wird zu einem TOML-„Punktschlüssel"-Pfad, den TOML-Parser als verschachtelt interpretieren werden. Um einen literalen Punkt im Schlüsselnamen zu erhalten, setzt ihn der Serializer in Anführungszeichen: `"my.key" = ...` — aber Konsumenten können ihn dennoch als Pfad parsen.
  • NaN / Infinity. TOML 1.0 unterstützt `nan`, `inf`, `-inf`-Literale. JSON repräsentiert diese nicht — sie kommen typischerweise als Strings `"NaN"`, `"Infinity"` etc. an. Konvertieren Sie manuell, wenn Sie echte TOML-Float-Spezialwerte brauchen.
Häufig gestellte Fragen

Wie werden Datumsangaben repräsentiert?

JSON-Datumsangaben sind ISO-8601-Strings, z. B. `"2026-04-26T12:00:00Z"`. Der Serializer behält sie als Strings in TOML — nicht als native Datetime-Typen. Um ein natives TOML-Datetime zu erhalten, müssten Sie auf der JavaScript-Seite vorverarbeiten und den Wert mit dem richtigen Typ-Marker ausgeben.

Werden tief verschachtelte Objekte abgeflacht?

Nein — sie werden zu verschachtelten `[a.b.c]`-Headern. Jede Verschachtelungsebene wird zu einem punktverbundenen Header-Pfad. Bei sehr tiefen Strukturen kann die Ausgabe lange Header-Zeilen haben; das ist einfach, wie TOML Tiefe ausdrückt.

Wird die Schlüsselreihenfolge erhalten?

Größtenteils. Der Serializer kanonisiert die Reihenfolge so, dass Primitive vor Untertabellen kommen (eine TOML-Regel). Innerhalb jeder Ebene wird die JSON-Einfügereihenfolge erhalten.

Wie bekomme ich eine TOML-Inline-Tabelle in der Ausgabe?

Sie können nicht — der Serializer verwendet immer `[section]`-Block-Header, niemals Inline-Tabellen. Wenn Sie Inline-Ausgabe brauchen, post-prozessieren Sie das Ergebnis. Inline-Tabellen sind ein TOML-Lesbarkeitsmerkmal, keine andere Datenform.

Wird mein JSON hochgeladen?

Nein. Alles läuft in Ihrem Browser — Ihre Eingabe wird durch JavaScript auf dieser Seite geparst und serialisiert und nie an einen Server gesendet.

Kann ich JSON → TOML → JSON Round-Trip machen?

Für unterstützte Typen (String, Zahl, Boolean, verschachteltes Objekt, Array von Objekten), ja. Round-Trips verlieren null-Werte (TOML hat kein null) und können die Schlüsselreihenfolge normalisieren.