Werkzeuge

YAML und JSON

Zwischen YAML und JSON hin und her wandeln.

Was es macht. Dieses Werkzeug wandelt YAML in JSON und umgekehrt. YAML markiert Struktur durch Einrückung, und genau dort geht es kaputt: ein Tabulator statt Leerzeichen macht die Datei ungültig.

Läuft im BrowserKein UploadKeine AnmeldungFunktioniert offline

So benutzt du YAML und JSON

Füg YAML oder JSON ein; das Format wird erkannt.
Sieh das Ergebnis oder die Fehlermeldung mit Zeilennummer.
Kopier die Ausgabe.

Mit Leerzeichen einrücken, nie mit Tabulatoren

Die wichtigste Regel in YAML und der häufigste Fehler.

YAML erlaubt keine Tabulatoren zur Einrückung. Nur Leerzeichen. Ein Editor, der stillschweigend Tabulatoren einfügt, liefert eine Datei, die richtig aussieht und nicht funktioniert.

Die Fehlermeldung führt dabei oft in die Irre: Sie zeigt auf eine Zeile weiter unten, wo die Struktur endgültig scheitert.

Stell in deinem Editor „Tabulatoren in Leerzeichen umwandeln" ein und mach Leerzeichen sichtbar, wenn du häufig mit YAML arbeitest.

Zwei Leerzeichen pro Ebene sind üblich. Wichtiger als die Anzahl ist, innerhalb einer Datei einheitlich zu bleiben.

Werte, die du nicht gemeint hast

YAML rät den Typ eines Werts, und das wendet sich an einigen Stellen gegen dich.

Die Werte „yes", „no", „on" und „off" werden in älteren YAML-Fassungen als Wahrheitswerte gelesen. Ein Ländercode „NO" für Norwegen wird dann zum Wert falsch. Setz solche Werte in Anführungszeichen.

Zahlen mit führenden Nullen können als Oktalzahlen gelesen werden. Eine Versionsnummer oder eine Postleitzahl gehört in Anführungszeichen.

Eine Uhrzeit wie 12:30 kann als etwas anderes denn Text aufgefasst werden. Auch hier: Anführungszeichen.

Faustregel: Alles, was eine Kennung ist statt eines berechenbaren Werts, kommt in Anführungszeichen.

Wann welches Format

YAML lässt sich angenehmer von Hand schreiben und lesen: weniger Klammern, Kommentare möglich, mehrzeiliger Text ohne Maskierung.

JSON ist strenger und dadurch verlässlicher für den Austausch zwischen Systemen. Keine Kommentare, keine Abhängigkeit von der Einrückung, weniger Möglichkeiten, etwas falsch zu deuten.

In der Praxis: Konfiguration, die Menschen bearbeiten, in YAML; Daten, die zwischen Systemen laufen, in JSON.

Beim Umwandeln zu beachten: Kommentare in YAML gehen beim Schritt zu JSON verloren, weil JSON keine kennt. Das lässt sich nicht zurückholen.

Alles läuft in dieser Seite.

Häufige Fragen

Warum ist mein YAML ungültig?

Meist ein Tabulator statt Leerzeichen. YAML erlaubt keine Tabulatoren zur Einrückung.

Warum wird NO zu falsch?

Älteres YAML liest yes, no, on und off als Wahrheitswerte. Setz sie in Anführungszeichen.

Wie viele Leerzeichen pro Ebene?

Zwei sind üblich. Einheitlichkeit ist wichtiger als die Anzahl.

Bleiben meine Kommentare erhalten?

Nicht beim Schritt zu JSON, das keine kennt.

Welches Format wähle ich?

YAML für Konfiguration von Hand, JSON für den Austausch zwischen Systemen.

Wird meine Datei verschickt?

Nein.