JSON in YAML umwandeln

JSON und YAML beschreiben dieselben Daten, nur in unterschiedlicher Schreibweise. JSON setzt auf geschweifte Klammern, Anführungszeichen und Kommas, während YAML die Struktur über Einrückungen abbildet. Genau das macht YAML für Konfigurationsdateien angenehmer zu lesen.

Ein kurzes Beispiel zeigt den Unterschied deutlich:

Du konvertierst meist dann, wenn ein System YAML erwartet, etwa bei Docker Compose, Kubernetes oder GitHub Actions. Eine API liefert ihre Antwort als JSON, doch deine Konfiguration soll im YAML-Format vorliegen.

Der Konverter liest deine JSON-Eingabe ein und gibt die gleichen Werte als YAML aus. Schlüssel, Werte und Reihenfolge bleiben erhalten, lediglich die Syntax ändert sich. Wer den umgekehrten Weg braucht, nutzt den YAML zu JSON Konverter.

Der Ablauf besteht aus drei Schritten. Zuerst prüft das Werkzeug deine Eingabe und zerlegt sie in einen internen Datenbaum. Ist das JSON fehlerhaft, etwa durch ein fehlendes Komma oder eine offene Klammer, erscheint ein Hinweis statt einer falschen Ausgabe.

Im zweiten Schritt wird dieser Datenbaum in die YAML-Struktur übertragen. Objekte werden zu Schlüssel-Wert-Paaren, Arrays zu Listen mit Bindestrichen und jede Verschachtelungsebene erhält eine zusätzliche Einrückung von zwei Leerzeichen.

Der dritte Schritt kümmert sich um Sonderfälle. Werte mit Doppelpunkten oder führenden Leerzeichen werden bei Bedarf in Anführungszeichen gesetzt, damit YAML sie korrekt interpretiert. Mehrzeilige Texte lassen sich über Blockschreibweisen abbilden.

Die gesamte Verarbeitung läuft lokal in deinem Browser. Deine Daten verlassen das Gerät nicht, was bei Konfigurationen mit Zugangsdaten ein klarer Vorteil ist. Vor der Umwandlung kannst du deine Eingabe mit dem JSON Formatter aufräumen, um Tippfehler früh zu erkennen.

Am häufigsten begegnet dir die Umwandlung bei Container- und CI/CD-Werkzeugen. Docker Compose, Kubernetes-Manifeste und Pipeline-Definitionen setzen fast durchgehend auf YAML, weil sich verschachtelte Einstellungen so übersichtlich lesen lassen.

Ein zweites Feld ist die Arbeit mit APIs. Viele Dienste antworten im JSON-Format, doch für eine dauerhafte Konfiguration möchtest du das Ergebnis in YAML ablegen. Der Konverter spart dir das fehleranfällige Abtippen von Hand.

Auch beim Datenaustausch zwischen Systemen ist die Umwandlung praktisch. Ein Werkzeug exportiert JSON, das nächste erwartet YAML. Statt eines eigenen Skripts genügt ein Einfügen in das Eingabefeld.

Weitere Beispiele aus der Praxis:

• Umzug bestehender Einstellungen in ein neues Format
• Vorlagen für wiederkehrende Konfigurationen erstellen
• Daten für die Dokumentation lesbarer aufbereiten

Wer statt YAML das TOML-Format braucht, findet im JSON zu TOML Konverter die passende Alternative für denselben Zweck.

Verschachtelte Strukturen sind der eigentliche Grund, warum YAML als lesbar gilt. Jede Ebene rückt um zwei Leerzeichen ein, sodass die Hierarchie auf einen Blick erkennbar bleibt. Der Konverter setzt diese Einrückung automatisch und konsistent.

Arrays werden zu Listen, deren Einträge mit einem Bindestrich beginnen. Enthält ein Array selbst wieder Objekte, kombiniert YAML Bindestrich und Einrückung, ohne dass du etwas anpassen musst.

Besondere Aufmerksamkeit verdienen Sonderzeichen. Werte wie true, false, null oder reine Zahlen können in YAML als Boolean, Null oder Zahl interpretiert werden. Soll ein solcher Wert ausdrücklich Text bleiben, setzt der Konverter Anführungszeichen. Gleiches gilt für Strings, die mit Doppelpunkt, Raute oder einem Leerzeichen beginnen.

Mehrzeilige Inhalte erscheinen als Blockwerte und behalten ihre Zeilenumbrüche. So gehen weder Struktur noch Bedeutung verloren, auch wenn die Eingabe komplex ist.

In den allermeisten Fällen ist die Umwandlung verlustfrei. JSON ist eine echte Teilmenge dessen, was YAML darstellen kann, deshalb lässt sich jeder gültige JSON-Inhalt vollständig in YAML abbilden. Schlüssel, Werte, Reihenfolge und Datentypen bleiben erhalten.

Kleine Unterschiede betreffen die Formatierung. YAML kennt keine Pflicht zu Anführungszeichen, daher wirken Schlüssel und einfache Texte ohne sie. Das ist eine bewusste Stilentscheidung des Formats und verändert die Daten nicht.

Grenzen entstehen vor allem bei der Eingabe. Ist das JSON ungültig, kann der Konverter es nicht zuverlässig deuten und meldet einen Fehler. Auch sehr große Dateien mit mehreren Megabyte können den Browser kurz beanspruchen.

Für eine saubere Ausgabe lohnt sich ein einfacher Test: Wandle das Ergebnis bei Bedarf mit dem umgekehrten Konverter zurück. Stimmen beide Datenstrukturen überein, war die Umwandlung korrekt und vollständig.