Was macht ein JSON-zu-YAML-Konverter?
Ein JSON-zu-YAML-Konverter schreibt JSON-Daten in YAML um („YAML Ain’t Markup Language“), ein menschenfreundliches Datenformat, das Einrückungen statt geschweifter Klammern und Anführungszeichen verwendet. Beide Formate bilden dieselben Datenstrukturen ab: Objekte (Maps), Arrays (Listen), Zeichenketten, Zahlen, Wahrheitswerte und null. YAML lässt sich viel leichter von Hand lesen und bearbeiten, deshalb dominiert es bei Konfigurationsdateien für Kubernetes, Docker Compose, GitHub Actions, GitLab CI, Ansible, Helm und OpenAPI.
Dieses Tool wandelt in beide Richtungen um. Fügen Sie JSON ein und erhalten Sie sauberes YAML, oder stellen Sie auf YAML → JSON um, um eine Konfigurationsdatei für eine API oder ein Programm in JSON zu verwandeln. Ungültige Eingaben werden mit Zeile und Spalte des Problems gemeldet.
So wandeln Sie JSON in YAML um
- JSON einfügen oder eine .json-Datei ablegen. Für die Gegenrichtung YAML einfügen oder eine .yaml-Datei ablegen.
- Richtung wählen: JSON → YAML oder YAML → JSON.
- Formatierung anpassen: Einrückung, Anführungszeichen, Schlüsselsortierung und kompakte Arrays.
- Kopieren oder herunterladen als .yaml- oder .json-Datei.
JSON und YAML im Beispiel
JSON:
{"service": {"name": "web", "ports": [80, 443], "env": {"DEBUG": false}}}
YAML:
service:
name: web
ports:
- 80
- 443
env:
DEBUG: false
Funktionen
- Beide RichtungenJSON in YAML und YAML in JSON in einem Tool.
- Standardkonformes YAMLBasiert auf js-yaml, einem weit verbreiteten Parser und Serializer für YAML 1.2.
- FehlermeldungenSyntaxfehler zeigen genaue Zeile und Spalte.
- Formatierung steuernEinrückung, Anführungszeichen, Schlüsselsortierung und Arrays im Flow-Stil.
- Sicheres ParsenYAML wird mit dem sicheren Schema geladen, Codeausführung ist ausgeschlossen.
- PrivatKonfigurationen mit Geheimnissen bleiben in Ihrem Browser.
JSON oder YAML: wann was?
| JSON | YAML | |
|---|---|---|
| Lesbarkeit | gut | hervorragend |
| Kommentare | nicht erlaubt | mit # möglich |
| Am besten für | APIs, Datenaustausch | Konfigurationsdateien |
| Leerzeichen relevant | nein | ja (Einrückung zählt) |
| Parsing-Geschwindigkeit | sehr schnell | langsamer |
Wo Sie die Umwandlung brauchen
- Kubernetes: Ausgaben von
kubectl get -o jsonin bearbeitbare YAML-Manifeste umwandeln. - OpenAPI / Swagger: API-Spezifikationen werden oft in YAML geschrieben und als JSON verarbeitet oder umgekehrt.
- CI/CD-Pipelines: GitHub Actions, GitLab CI, CircleCI und Azure Pipelines nutzen alle YAML.
- Infrastructure as Code: Ansible-Playbooks, CloudFormation-Vorlagen und Helm-Values-Dateien.
Das Wichtigste zur YAML-Syntax
- Maps schreibt man als
schlüssel: wert, Verschachtelung entsteht durch Einrückung (meist zwei Leerzeichen). - Listen nutzen Bindestrich und Leerzeichen (
- eintrag) oder den Flow-Stil[a, b, c]. - Zeichenketten brauchen meist keine Anführungszeichen, wohl aber, wenn sie
:oder#enthalten, mit Sonderzeichen beginnen oder als Zahl oder Wahrheitswert missverstanden werden könnten (etwa'3.10','yes','on'). - Kommentare beginnen mit
#und reichen bis zum Zeilenende. - Mehrzeilige Texte nutzen
|, um Zeilenumbrüche zu behalten, oder>, um sie zusammenzufalten. - Mehrere Dokumente in einer Datei werden mit
---getrennt, wie in Kubernetes-Manifesten mit mehreren Ressourcen.
Das „Norwegen-Problem“ und andere YAML-Fallen
Ältere YAML-1.1-Parser lasen unquotierte Werte wie NO, yes, on und off als Wahrheitswerte. Der Ländercode für Norwegen konnte so unbemerkt zu false werden. Versionsnummern wie 3.10 können außerdem zur Zahl 3,1 werden. Bei der Umwandlung von JSON in YAML setzt dieses Tool Zeichenketten, die YAML 1.2 als anderen Typ lesen würde, automatisch in Anführungszeichen, etwa '3.10', 'true', 'null' oder '0123'. Wird Ihr YAML von einem älteren YAML-1.1-Parser gelesen (etwa PyYAML oder manchen CI-Systemen), wählen Sie unter „Anführungszeichen für Strings“ einfache oder doppelte Anführungszeichen; dann wird jede Zeichenkette gequotet, was auch Wörter wie yes, no, on und off schützt. Bei YAML → JSON gilt das strikte JSON-Schema, nur true und false werden zu Wahrheitswerten. Zum Prüfen und Formatieren von JSON gibt es JSON formatieren, für XML JSON in XML.
Häufige Fragen
Ist der JSON-zu-YAML-Konverter kostenlos?
Ja, ohne Grenzen. Fügen Sie JSON oder YAML beliebiger Größe ein und wandeln Sie es sofort im Browser um.
Kann das Tool YAML mit mehreren Dokumenten umwandeln?
Die Richtung YAML → JSON liest ein einzelnes Dokument. Bei Dateien mit mehreren durch --- getrennten Dokumenten fügen Sie jeweils ein Dokument ein.
Behält das YAML die Reihenfolge der Schlüssel?
Ja. Die Schlüssel erscheinen in derselben Reihenfolge wie im JSON, außer Sie aktivieren „Schlüssel A–Z sortieren“.
Ist YAML eine Obermenge von JSON?
Ja. YAML 1.2 ist so angelegt, dass gültiges JSON auch gültiges YAML ist. Umgekehrt gilt das nicht: YAML-Funktionen wie Kommentare und Anker haben kein JSON-Gegenstück.
Was passiert mit YAML-Kommentaren bei der Umwandlung in JSON?
JSON kennt keine Kommentare, sie fallen weg. Eine Rückumwandlung in YAML stellt sie nicht wieder her.
Warum muss YAML mit Leerzeichen eingerückt werden?
Die YAML-Spezifikation verbietet Tabulatoren zur Einrückung. Dieses Tool gibt immer Leerzeichen aus, 2 oder 4 pro Ebene.
Wird meine Konfiguration hochgeladen?
Nein. Die Umwandlung geschieht vollständig in Ihrem Browser, Geheimnisse und Zugangsdaten in Konfigurationen bleiben privat.