JSON ↔ YAML Konverter
Wandeln Sie JSON in YAML um und YAML wieder zurück in JSON – direkt in Ihrem Browser. Fügen Sie eines der beiden Formate ein und erhalten Sie eine saubere, korrekt eingerückte Ausgabe – ideal für Konfigurationsdateien, CI-Pipelines und Kubernetes-Manifeste.
Einrückung
Geben Sie oben Daten ein, um hier das umgewandelte Ergebnis zu sehen.
So verwenden Sie JSON-zu-YAML-Konverter
- 1
Richtung wählen
Wählen Sie mit dem Umschalter JSON zu YAML oder YAML zu JSON. Die Tausch-Schaltfläche verschiebt Ihr Ergebnis in die Eingabe, sodass Sie es wieder zurückwandeln können.
- 2
Daten einfügen
Fügen Sie JSON oder YAML in das Eingabefeld ein. Die Umwandlung läuft automatisch, während Sie tippen, wobei Struktur, Verschachtelung und Datentypen erhalten bleiben.
- 3
Einrückung wählen
Wählen Sie eine Einrückung von 2 oder 4 Leerzeichen passend zum Stil Ihres Projekts. Die Ausgabe bleibt sauber und für beide Formate korrekt eingerückt.
- 4
Ergebnis kopieren
Prüfen Sie die umgewandelte Ausgabe und kopieren Sie sie in die Zwischenablage – bereit zum Einfügen in eine Konfigurationsdatei, eine Pipeline oder Ihren Code.
Von JSON zu YAML: Sauberere Konfiguration ohne die Fußangeln
YAML ist eine Obermenge von JSON
Jedes gültige JSON-Dokument ist zugleich gültiges YAML – das ist eine Garantie der YAML-Spezifikation, kein Zufall. YAML fügt obendrauf eine menschenfreundlichere Schicht hinzu: Statt geschweifter und eckiger Klammern wird die Struktur durch Einrückung ausgedrückt; statt Kommata stehen Elemente auf eigenen Zeilen; und anders als JSON unterstützt YAML Kommentare. Das Ergebnis liest sich wie eine Gliederung statt wie eine Datenhalde, weshalb es Konfigurationsdateien beherrscht.
Da die Datenmodelle so eng aufeinander abgestimmt sind – beide haben Maps, Sequenzen, Zeichenketten, Zahlen, boolesche Werte und null –, ist die Umwandlung zwischen ihnen mechanisch und für die Werte selbst verlustfrei. Die Umwandlung drückt denselben Baum in einer anderen Oberflächensyntax aus. Das Einzige, was einen JSON-Hin-und-Rücklauf nicht überstehen kann, sind Kommentare, da JSON keinen Ort hat, sie unterzubringen.
Einrückung ist die Syntax
In YAML ist Leerraum nicht kosmetisch – er ist die Struktur. Verschachtelung wird gezeigt, indem man untergeordnete Schlüssel weiter einrückt als ihren übergeordneten, und Elemente auf derselben Tiefe müssen dieselbe Einrückung teilen. Eine unter einem Schlüssel verschachtelte Map wird zu einem Satz eingerückter Zeilen darunter; eine Liste wird zu Zeilen, von denen jede mit einem Bindestrich beginnt. Machen Sie die Einrückung falsch, ändern Sie die Bedeutung, nicht bloß das Erscheinungsbild, was das Gegenteil davon ist, wie JSON mit Leerraum umgeht.
Wählen Sie eine einheitliche Einrückungsbreite – zwei Leerzeichen sind die verbreitete Voreinstellung für Konfigurationsdateien, vier bei manchen Hausstilen – und wenden Sie sie überall an. Der Umwandler gibt eine saubere, einheitliche Einrückung aus, sodass Sie von einer korrekten Grundlage aus starten, statt Zeilen von Hand auszurichten.
Tabulatoren sind verboten
Dies ist die Regel, die fast jeden beim ersten Mal erwischt. Die YAML-Spezifikation untersagt Tabulatorzeichen für die Einrückung ausdrücklich; Sie müssen Leerzeichen verwenden. Ein Editor, der so konfiguriert ist, beim Drücken der Tabulatortaste einen Tabulator einzufügen, erzeugt stillschweigend eine Datei, die nicht geparst werden kann, oft mit einer Fehlermeldung, die auf die falsche Stelle zeigt, weil der Parser erst ein, zwei Zeilen später bemerkt, dass die Struktur kaputt ist.
Wenn eine YAML-Datei sich weigert zu laden und die Einrückung korrekt aussieht, prüfen Sie zuerst auf Tabulatoren. Konfigurieren Sie Ihren Editor so, dass er Leerraum anzeigt oder Tabulatoren bei YAML-Dateien in Leerzeichen umwandelt. Das Umwandeln aus JSON umgeht dies vollständig, da die erzeugte Ausgabe von Anfang an mit Leerzeichen eingerückt ist.
Das Norwegen-Problem und andere überraschende boolesche Werte
Ältere YAML-Parser interpretieren eine erstaunliche Bandbreite nackter Wörter als boolesche Werte: nicht nur true und false, sondern auch yes, no, on und off in verschiedenen Schreibweisen. Die klassische Katastrophe ist eine Liste von Ländercodes, bei der der Eintrag für Norwegen, geschrieben als die nackten Buchstaben n und o, als der boolesche Wert false gelesen wird und still aus Ihren Daten verschwindet. Als on oder off geschriebene Umschaltflags können auf dieselbe Weise den Typ wechseln.
Die Verteidigung ist die Anführungszeichensetzung. Jede Zeichenkette, die mit einem booleschen Wert, einer Zahl, einem Datum oder null verwechselt werden könnte, sollte in Anführungszeichen gesetzt werden, damit der Parser sie als Text behält. Moderne, um das sichere Schema herum gebaute Parser sind strenger und weit weniger anfällig dafür, doch die Gewohnheit, mehrdeutige Skalare in Anführungszeichen zu setzen, ist es wert, beibehalten zu werden, besonders bei kurzen Codes, versionsähnlichen Zeichenketten und allem von Nutzern Gelieferten.
Weitere Skalar-Fallstricke: Zahlen, führende Nullen und null
Einige andere nackte Werte überraschen Menschen. Eine Postleitzahl oder Teilenummer mit einer führenden Null wird womöglich als Zahl gelesen und verliert die Null oder wird in manchen Parsern als Oktalzahl interpretiert. Versionszeichenketten wie 1.20 können zur Zahl 1.2 umgewandelt werden, was die nachgestellte Null fallen lässt. Das Wort null, ein leerer Wert und eine allein stehende Tilde bedeuten allesamt null. Wie bei der booleschen Falle ist die Abhilfe dieselbe: Setzen Sie alles in Anführungszeichen, dessen textuelle Form von Bedeutung ist.
Da dieses Werkzeug mit dem sicheren Schema parst, lädt es nur Standard-Datentypen und konstruiert niemals beliebige Objekte oder führt Code aus, sodass das Einfügen nicht vertrauenswürdigen YAMLs nichts ausführen kann. Das hält die Umwandlung vorhersehbar: Was Sie zurückbekommen, sind reine Maps, Sequenzen und Skalare, ohne überraschende benutzerdefinierte Typen, die über Tags eingeschleust werden.
Wo YAML tatsächlich lebt
YAMLs Lesbarkeit machte es zur Lingua franca von Infrastruktur- und CI-Werkzeugen. Docker-Compose-Dateien, Kubernetes-Manifeste, GitHub-Actions- und GitLab-CI-Pipelines, Ansible-Playbooks und unzählige Anwendungskonfigurationsdateien sind allesamt YAML. In jedem einzelnen davon sind die Kommentare und sauberen Diffs, die YAML erlaubt, ein echter Vorteil, wenn ein Mensch eine Änderung an der Produktionskonfiguration überprüfen muss.
JSON hingegen bleibt die bessere Wahl für den Austausch von Maschine zu Maschine über APIs, wo seine Strenge und das Fehlen von Leerraum-Empfindlichkeit Mehrdeutigkeit verringern. Ein verbreitetes Muster ist, zur menschlichen Bequemlichkeit in YAML zu verfassen und zu bearbeiten und dann zu JSON umzuwandeln, wenn ein Werkzeug oder Endpunkt es verlangt – was genau der Grund ist, warum dieser Umwandler in beide Richtungen läuft.
Blockstil, Flussstil und die Ausgabe lesen
YAML kann dieselben Daten auf zwei Weisen ausdrücken. Der Blockstil verteilt Maps und Listen über eingerückte Zeilen und ist das, was Sie für lesbare Konfiguration wollen. Der Flussstil verwendet eingebettete geschweifte und eckige Klammern und sieht fast genau wie JSON aus, was gelegentlich praktisch für kurze, kompakte Werte ist, die in ein größeres Dokument eingebettet sind. Beide zu kennen hilft Ihnen, von anderen geschriebenes YAML ohne Verwirrung zu lesen.
Wenn Sie hier umwandeln, fügen Sie das JSON ein, wählen Ihre Einrückungsbreite und überprüfen die Ausgabe im Blockstil, bevor Sie sie in ein Repository einsetzen. Alles geschieht lokal in Ihrem Browser, sodass Geheimnisse in einer Konfigurationsdatei – Tokens, Verbindungszeichenketten, interne Hostnamen – niemals Ihr Gerät verlassen, was es sicher macht, echte Bereitstellungsmanifeste statt bereinigter Beispiele umzuwandeln.
Häufig gestellte Fragen
Was ist der Unterschied zwischen JSON und YAML?
Wie wandle ich JSON in YAML um?
Kann es YAML wieder in JSON umwandeln?
Ist das Parsen von nicht vertrauenswürdigem YAML hier sicher?
Werden meine Daten auf einen Server hochgeladen?
Verwandte Tools
Machen Sie weiter mit diesen praktischen Tools