JSON-zu-YAML-Konverter

So nutzen Sie den JSON-zu-YAML-Konverter

1. Wählen Sie die Richtung: „JSON → YAML“ oder „YAML → JSON“.
2. Fügen Sie Ihre Daten ein oder klicken Sie auf „Datei öffnen“, um eine .json-, .yaml- oder .yml-Datei zu laden (bis 10 MB).
3. Wählen Sie die „Einrückung“ (2 oder 4 Leerzeichen) und bei Bedarf „Schlüssel sortieren“ für eine alphabetische Reihenfolge.
4. Klicken Sie auf „Umwandeln“ oder tippen Sie einfach weiter: Das Ergebnis aktualisiert sich automatisch. Ist die Eingabe ungültig, nennt die Fehlermeldung Zeile und Spalte des Problems.
5. Kopieren oder laden Sie das Ergebnis herunter. „Richtung tauschen“ schickt die Ausgabe zurück in die Eingabe, um sie in die andere Richtung umzuwandeln.

JSON und YAML: gleiche Daten, andere Syntax

In der Praxis ist YAML eine Obermenge von JSON: Alle Daten, die ein JSON-Dokument beschreibt, kann YAML ebenfalls ausdrücken – mit einer schlankeren Syntax, die Menschen leichter lesen und bearbeiten können. Deshalb werden Kubernetes-Manifeste, Docker-Compose-Dateien, GitHub-Actions- und GitLab-CI-Pipelines, Ansible-Playbooks und OpenAPI-Spezifikationen meist in YAML geschrieben, während APIs und Programme JSON austauschen.

Dieselben Daten in beiden Formaten:

{"name": "web", "ports": [80, 443], "env": {"DEBUG": false}}

name: web
ports:
  - 80
  - 443
env:
  DEBUG: false

JSON → YAML

Der Konverter schreibt YAML im Blockstil: ein Schlüssel pro Zeile, Listen mit Bindestrichen und eingerückte verschachtelte Objekte. Lange Zeichenketten werden nie umbrochen, und mehrzeilige Zeichenketten verwenden den Literal-Stil |, damit Zeilenumbrüche exakt erhalten bleiben. Zeichenketten, die YAML sonst als anderen Typ lesen würde, werden in Anführungszeichen gesetzt: "yes", "1.0" oder "null" bleiben auch nach einer Rückumwandlung Zeichenketten. „Schlüssel sortieren“ ordnet die Schlüssel jedes Objekts alphabetisch, was den Vergleich zweier Konfigurationsdateien erleichtert.

YAML → JSON

Das YAML wird mit dem Core-Schema von YAML 1.2 gelesen, also nach denselben Regeln wie in den meisten modernen Tools:

• true/false, Zahlen und null (oder ~) werden zu JSON-Werten; yes, no, on und off bleiben Zeichenketten, wie es die Spezifikation von YAML 1.2 verlangt.
• Anker und Aliase (&base, *base) werden aufgelöst, und Merge-Keys (<<: *base), wie sie in CI-Dateien üblich sind, werden unterstützt.
• Eine Datei mit mehreren durch --- getrennten Dokumenten wird zu einem JSON-Array mit einem Element pro Dokument; eine Meldung sagt Ihnen, wie viele zusammengefasst wurden.
• Kommentare entfallen, da JSON keine Kommentare kennt.
• .inf und .nan haben keine Entsprechung in JSON; sie werden als Zeichenketten "Infinity" und "NaN" geschrieben.

Zum Schutz Ihres Browsers vor „Billion Laughs“-Dateien, in denen wenige Aliase zu Milliarden von Werten anwachsen, wird ein Dokument abgelehnt, das sich zu mehr als einer Million Werten auflöst.

Häufige YAML-Fehler

• Tabulatoren zum Einrücken: YAML erlaubt nur Leerzeichen.
• Uneinheitliche Einrückung: Elemente derselben Liste oder desselben Objekts müssen in derselben Spalte beginnen.
• Fehlendes Leerzeichen nach dem Doppelpunkt: key:value ist eine einzige Zeichenkette, key: value dagegen ein Schlüssel-Wert-Paar.
• Sonderzeichen ohne Anführungszeichen: Ein Wert, der mit @, einem Backtick, *, & oder ! beginnt oder : bzw. # enthält, muss in Anführungszeichen stehen.