JSON to YAML Converter

So verwendest du den JSON-zu-YAML-Konverter

1. Füge JSON in den Eingabebereich ein. Ein vollständiges Dokument, eine aus DevTools kopierte API-Antwort oder ein JSON-Objekt-Body aus Postman funktionieren alle. Der Konverter validiert beim Klicken auf "Konvertieren".
2. Klicke auf "In YAML konvertieren". Objekte werden zu Block-Mappings, Arrays zu Block-Sequenzen mit - -Markern, und Primitive behalten ihre Typen.
3. Überprüfe das YAML im Ausgabebereich. Wenn die Eingabe ungültiges JSON ist, meldet das rote Fehlerbanner den Zeichen-Offset des Problems.
4. Kopiere das Ergebnis in dein Kubernetes-Manifest, deine Docker-Compose-Datei oder dein Ansible-Playbook. Die Ausgabe verwendet zwei Leerzeichen Einrückung, was der De-facto-Standard im gesamten Ökosystem ist.

Im Konverter

Der erste Schritt ist JSON.parse, der einen JavaScript-Wertbaum zurückgibt. Das gibt dem Konverter einen strikten Eingabevertrag: Doppelte Schlüssel sind bereits kollabiert (der letzte gewinnt in jedem modernen JSON-Parser), numerische Strings bleiben Strings, und die einzigen möglichen Werttypen sind Objekte, Arrays, Strings, Zahlen, Booleans und null. Der Konverter geht dann diesen Baum rekursiv durch und gibt YAML-Block-Syntax mit Einrückung proportional zur Tiefe aus.

Strings werden nur bei Bedarf zitiert: Werte, die mit YAML-reservierten Token mehrdeutig wären (true, false, null, yes, no), Werte, die als Zahlen geparst werden, Werte, die mit Sonderzeichen beginnen (-, :, ?, !, &, *, [, {), oder Werte, die Zeilenumbrüche oder eingebettete Anführungszeichen enthalten. Das entspricht den YAML-1.2-Regeln für einfache Skalare, beschrieben unter yaml.org/spec. Leere Arrays geben [] und leere Objekte geben {} im Flow-Stil aus, weil der Block-Stil keine Möglichkeit hat, eine leere Sammlung zu zeigen.

Szenarien, wo das praktisch ist

• Eine JSON-Konfigurationsdatei zu YAML migrieren für ein Tool wie Serverless Framework oder Helm, das YAML erwartet.
• API-Antworten in YAML konvertieren für die Einbeziehung in Dokumentation, wo die Lesbarkeit von YAML JSON-Klammern-Suppe schlägt.
• Test-Fixtures für Go-, Python- oder Ruby-Tests vorbereiten, die YAML-Loader verwenden.
• Einen in Postman gespeicherten Anfrage-Body nehmen und in ein YAML-Snippet für eine README umwandeln.
• Eine Kubernetes-ConfigMap erstellen, deren Daten als JSON von einem vorgelagerten Dienst stammen.
• Ein lesbares Diff einer großen JSON-Konfiguration erzeugen, indem beide Versionen in YAML konvertiert und die YAML-Dateien gedifft werden.

Randfälle

• Numerische Strings. Ein JSON-Wert von "123" (String) wird zu YAML '123', damit er nicht später als Zahl neu geparst wird. Ohne die Anführungszeichen würde ein YAML-Parser ihn als Ganzzahl zurück roundtrippen.
• Spezielle Float-Werte. JSON hat kein NaN oder Infinity - das ist ungültiges JSON. Wenn deine Quelle JavaScript-artige Ausgabe mit diesen hat, entferne sie zuerst.
• Schlüsselzeichen. Schlüssel, die Doppelpunkte, Leerzeichen oder Sondermarker enthalten, werden zitiert. YAML erlaubt fast jeden String als Schlüssel, aber ein bloßes Wort ist einfacher zu lesen, also zitiert der Konverter nur bei Bedarf.
• Doppelt aussehende Schlüssel. JSON erlaubt doppelte Schlüssel syntaktisch, aber Parser kollabieren sie. Wenn der Konverter die Daten sieht, gibt es bereits nur einen von jedem Schlüssel, also sind Duplikate aus der ursprünglichen Quelle bereits verloren.
• Tief verschachtelte Strukturen. Einrückung um zwei Leerzeichen bedeutet, dass 20-Ebenen-tiefes JSON 40 führende Leerzeichen pro Zeile produziert. Das ist gültiges YAML, aber schwer zu lesen; erwäge, die Quelle umzustrukturieren, wenn die Tiefe so extrem ist.

Warum JSON und YAML koexistieren

JSON wurde in RFC 8259 (und parallel als ECMA-404) spezifiziert. Es optimiert für maschinelles Parsing: eine kleine strikte Grammatik, keine Kommentare, keine mehrzeiligen Strings, keine Referenzen. YAML, spezifiziert unter yaml.org, optimiert für menschliche Lesbarkeit: einrückungsgesteuerte Struktur, Kommentare, Anker und explizite Typ-Tags. Eine Korrektheitskonsquenz, die es wert ist zu wissen: Jedes JSON-Dokument ist gültiges YAML 1.2 (YAML ist eine strikte Obermenge), aber das Umgekehrte gilt nicht - die meisten echten YAML haben Funktionen, die JSON nicht ausdrücken kann. Diese Asymmetrie ist der Grund, warum YAML dazu neigt, Konfigurationsdateien zu dominieren (von Hand bearbeitet, kommentiert), während JSON Wire-Formate dominiert (maschinell generiert, maschinell konsumiert). Kubernetes akzeptiert beide für dieselbe API und normalisiert intern zu JSON vor der Verarbeitung.

Alternative Konverter

Das Go-basierte yq-Tool (von mikefarah/yq) ist der Community-Favorit für geskriptete Konvertierung. yq -P '.' file.json erzeugt hübsches YAML, das dem Kubernetes-Stilhandbuch entspricht. Python-Benutzer haben ruamel.yaml, das Reihenfolge und Kommentare bewahrt, wenn du jemals zurück roundtrippst. Editor-Plugins (VS Code Redhat YAML, IntelliJ YAML) bieten visuelle JSON-zu-YAML-Konvertierung mit Schema-Validierung. Dieses In-Browser-Tool ist am schnellsten für einmalige Konvertierungen und vermeidet die Sicherheitsreibung des Einfügens proprietärer JSON in einen Cloud-Dienst, aber für wiederholbare Pipeline-Nutzung sind die CLI-Tools oben besser.