JSON in YAML und YAML in JSON umwandeln (ohne Ihre Werte zu verfälschen)
JSON in YAML oder YAML in JSON umwandeln, für Kubernetes, Docker Compose und CI. Das Norwegen-Problem, Tab- und Einzugsfallen und was verloren geht.
Aktualisiert am 7. November 20269 Min. Lesezeit
Um JSON in YAML umzuwandeln, fügen Sie das JSON in den JSON-zu-YAML-Konverter ein, wählen den Parser, für den Ihr YAML gedacht ist, und klicken auf In YAML konvertieren. Für die Gegenrichtung fügen Sie das YAML in den YAML-zu-JSON-Konverter ein. Beides dauert Sekunden. Lesenswert ist, was schiefgehen kann: YAML rät den Typ von Wörtern ohne Anführungszeichen, sodass ein Ländercode wie no zu false werden kann, eine Dateiberechtigung zu einer anderen Zahl und ein Datum zu etwas, das kein Text mehr ist. Dieser Ratgeber behandelt beide Richtungen, diese Fallen und das, was unterwegs verloren geht.
Zwei Richtungen, zwei Werkzeuge
JSON und YAML beschreiben dieselben Arten von Daten: Objekte, Listen, Text, Zahlen, wahr oder falsch und null. JSON ist streng und laut, mit geschweiften und eckigen Klammern und Anführungszeichen überall. YAML lässt das meiste weg und arbeitet stattdessen mit Einrückung, weshalb man es für Dateien bevorzugt, die man von Hand bearbeitet. Jede Richtung hat ein eigenes Werkzeug mit eigenen Grenzen.
| Sie haben | Sie möchten | Werkzeug | Kostenlose Grenze |
|---|---|---|---|
| JSON, eine API-Antwort oder ein Export | YAML | JSON zu YAML | Eine Datei bis 10 MB |
| Eine YAML-Konfiguration oder ein Manifest | JSON | YAML zu JSON | Eine Datei bis 25 MB |
| JSON, das sich nicht parsen lässt | Korrigiertes JSON | JSON-Validator | Siehe Werkzeugseite |
| Unordentliches JSON in einer Zeile | Lesbares JSON | JSON-Formatierer | Siehe Werkzeugseite |
Die Grenzen unterscheiden sich, weil die Arbeit sich unterscheidet. JSON in YAML umzuwandeln heißt, das ganze Dokument als lebende Objekte im Speicher zu halten, während das YAML geschrieben wird, daher endet dieses Werkzeug bei 10 MB. Das Lesen von YAML durchläuft den Text, deshalb ist dort bis 25 MB Platz.
JSON in YAML umwandeln, Schritt für Schritt
Ihr JSON hinzufügen
Öffnen Sie den JSON-zu-YAML-Konverter. Fügen Sie das JSON in den Editor ein und klicken Sie auf Dieses JSON verwenden, oder ziehen Sie eine .json-, .ndjson- oder .jsonl-Datei auf die Seite.
Den Ziel-Parser wählen
Voreingestellt ist Portabel. Es setzt jeden Wert in Anführungszeichen, den ein älterer oder datumsfähiger YAML-Leser als anderen Typ lesen würde. YAML 1.2 quotiert nur, was ein moderner Parser braucht. Alles quotieren setzt jeden String in Anführungszeichen, wenn Sie nicht wissen, was die Datei lesen wird.
Das Layout festlegen
Wählen Sie einen Einzug von 1 bis 8 Leerzeichen (2 ist die Voreinstellung), einen Null-Stil aus null, ~ oder leer und ob die Datei mit --- beginnt.
Konvertieren und das Siegel lesen
Klicken Sie auf In YAML konvertieren. Ist Ergebnis prüfen eingeschaltet, wird das YAML mit einem unabhängigen Parser zurückgelesen und mit Ihrem JSON verglichen. Das Siegel meldet Geprüft oder nennt den ersten Pfad, an dem ein Wert anders zurückkam.
Herunterladen oder kopieren
Nutzen Sie YAML herunterladen oder Kopieren. Die Vorschau zeigt bei großen Dateien die ersten Zeilen, der Download enthält aber das ganze Ergebnis.
YAML in JSON umwandeln
Fügen Sie YAML in den YAML-zu-JSON-Konverter ein oder ziehen Sie eine .yaml- oder .yml-Datei hinein. Beispielschaltflächen für Kubernetes, Docker Compose und GitHub Actions laden eine typische Datei, damit Sie das Ergebnis zuerst sehen. Alle Ausgabeeinstellungen sind kostenlos:
- Einzug: 2 Leerzeichen, 4 Leerzeichen, Tabs oder Minimiert (eine Zeile, ohne Leerraum).
- Dokumente: Automatisch (ein Dokument wird zum Objekt, mehrere zu einem Array), Immer Array, Nur erstes oder Einzelne Dateien, eine .json pro Dokument.
- Schlüssel sortieren: bringt die Schlüssel jedes Objekts in eine feste Reihenfolge, damit sich zwei Umwandlungen sauber vergleichen lassen.
- Doppelte Schlüssel: Ablehnen, wobei die Zeile genannt wird, oder Letzten behalten.
- NaN und Infinity: null schreiben, Als Text oder Anhalten. JSON hat keinen Wert für .nan oder .inf.
- Zeitstempel: Wie geschrieben oder ISO 8601.
Anker und Aliasse werden dort ausgeschrieben, wo sie verwendet werden, und Merge-Schlüssel wie <<: *common werden aufgelöst; direkt in einem Mapping geschriebene Schlüssel überschreiben die zusammengeführten. Tags wie !Ref werden auf den darunterliegenden Wert reduziert, und die Tag-Namen stehen unter dem Ergebnis.
Parser wählen, konvertieren und ein geprüftes Ergebnis erhalten. Kostenlos: eine Datei bis 10 MB, mit allen Einstellungen, die die Korrektheit betreffen. Pro: bis zu 50 Dateien als ZIP, dazu Ausgabestile. Alles läuft auf Ihrem Gerät, nicht auf unseren Servern.
JSON in YAML umwandelnDas Norwegen-Problem und andere stille Typwechsel
In YAML 1.1, der Version, die PyYAML, Ansible und Rubys Psych noch verwenden, sind die einfachen Wörter yes, no, on, off, y und n Booleans. Eine Liste von Ländercodes mit NO (Norwegen) kommt daher mit false an dieser Stelle zurück. Es wird kein Fehler gemeldet; die Daten sind einfach falsch. YAML 1.2 hat diese Regel abgeschafft, sodass manche Parser dieselbe Datei anders lesen als andere. Für genau diese Uneinigkeit gibt es die Einstellung Ziel-Parser.
| Wert in Ihrem JSON | Was ein älterer YAML-Leser daraus machen kann | Ziel Portabel |
|---|---|---|
| "no", "yes", "on", "off" | Booleans, aus "no" wird false | Quotiert |
| "0755" | Eine Oktalzahl, 493 | Quotiert |
| "1:30" | Eine Zahl zur Basis 60, 90 | Quotiert |
| "2024-01-01" | Ein Datumsobjekt, kein Text | Quotiert |
| "true", "null", "12" | Ein Boolean, null oder eine Zahl, in jeder YAML-Version | Quotiert (in jedem Modus) |
| "hello" | Text | Unquotiert |
Portabel quotiert genau die Werte aus dieser Tabelle und lässt gewöhnliche Wörter in Ruhe, sodass die Datei lesbar bleibt. Der Modus YAML 1.2 quotiert weniger und ist nur dann korrekt, wenn die Datei von einem 1.2-Parser ohne Datumserkennung gelesen wird; das Werkzeug zählt trotzdem, wie viele Werte ein älterer Leser ändern würde, und sagt es Ihnen. Schlüssel werden nach denselben Regeln quotiert, denn ein unquotierter Schlüssel n oder yes wird in einem 1.1-Leser zum Boolean. In der Gegenrichtung folgt YAML zu JSON den Regeln von YAML 1.2: yes, no, on und off bleiben Strings, und ein Zeitstempel wie 2001-12-14 bleibt der Text, den Sie getippt haben, es sei denn, Sie wählen ISO 8601.
Einzug, Tabs und leere Werte
Die Struktur von YAML ist die Einrückung. Zwei Leerzeichen mehr bedeuten ein Kind, gleiche Einrückung bedeutet ein Geschwister. Eine einzige Zeile, die ein Leerzeichen zu weit eingerückt ist, ändert die Form der Daten oder bricht das Parsen ab. Tabs sind der klassische Fehler: YAML verbietet sie für die Einrückung, und eine Datei, die in einem Editor mit Tabstopps ausgerichtet aussieht, kann sich weigern zu laden. Der YAML-zu-JSON-Konverter meldet Zeile und Spalte des Fehlers, mit einigen Zeilen Ihres eigenen Quelltexts und einem Zeiger darunter. Ersetzen Sie den Tab durch Leerzeichen und konvertieren Sie erneut.
Bei JSON zu YAML besteht dieses Risiko nicht, weil das Werkzeug die Einrückung selbst schreibt. Leere Container werden als {} und [] geschrieben statt leer gelassen, weil ein leerer Wert als null zurückgelesen wird. Text mit Zeilenumbrüchen wird zu einem lesbaren |-Block, sodass ein Skript oder Zertifikat seine Zeilen behält. Kann ein Block den Text nicht exakt darstellen, etwa wenn die erste Zeile leer oder eingerückt ist oder ein Wagenrücklauf vorkommt, wird der Text stattdessen quotiert. Stille Änderungen sind schlimmer als hässliche Ausgabe.
Was beim Wechsel zu JSON verloren geht: Kommentare und geteilte Knoten
JSON kennt keine Kommentare. Wenn Sie YAML in JSON umwandeln, fällt jeder #-Kommentar weg, und mit ihm die Dokumentation, die er enthielt. Behalten Sie das YAML als maßgebliche Quelle und behandeln Sie das JSON als Build-Ergebnis. Beim Weg von JSON zu YAML können Sie Kommentare schreiben, beginnen aber ohne welche, also fügen Sie sie nach der Umwandlung hinzu.
Aliasse werden ebenfalls aufgelöst. Zwei Stellen, die auf einen Anker verwiesen, werden im JSON zu zwei identischen Kopien, weil JSON nicht ausdrücken kann, dass es derselbe Knoten war. Wandeln Sie zurück, erhalten Sie ein YAML, das länger ist als das Original. Ein zirkulärer Alias, bei dem ein Anker auf sich selbst verweist, ist gültiges YAML, aber in JSON unmöglich, und der Konverter meldet ihn mit dem Pfad, statt stillschweigend zu scheitern.
Typische Einsatzfälle: Kubernetes, Docker Compose und CI-Dateien
- Kubernetes: Ein durch --- getrenntes Manifest besteht aus mehreren Dokumenten. Nutzen Sie Automatisch oder Immer Array, um sie als JSON für ein Werkzeug zu erhalten, das es erwartet, oder Einzelne Dateien für je eine .json. Beim Weg zu YAML legen Sie das Layout fest und prüfen das Siegel, denn eine Versionsangabe wie "1.20" muss Text bleiben.
- Docker Compose: Ein mit <<: *common definierter Service kommt mit zusammengeführten gemeinsamen Schlüsseln heraus. Portzuordnungen wie "22:22" sind die 1.1-Falle in der Praxis, da ein nacktes 22:22 als Zahl zur Basis 60 gelesen werden kann. Portabel quotiert sie.
- CI-Dateien wie GitHub-Actions-Workflows: Der Schlüssel on bleibt der String "on", nicht true. Das ist die richtige Lesart für einen 1.2-Parser. Um zwei Workflow-Dateien zu vergleichen, wandeln Sie beide mit eingeschaltetem Schlüssel sortieren um; das ändert die Reihenfolge, nicht die Bedeutung.
- API-Nutzdaten: Machen Sie aus einer JSON-Antwort eine YAML-Startkonfiguration oder aus einer YAML-Einstellungsdatei einen Body für einen Dienst, der kein YAML liest.
Um zu sehen, wie sich zwei Konfigurationen unterscheiden, wandeln Sie beide um, sortieren die Schlüssel und vergleichen das JSON; Reihenfolge- und Kommentaränderungen erscheinen dann nicht mehr als Unterschiede. Zum vorherigen Aufräumen von JSON siehe JSON online formatieren, für XML-Quellen XML in JSON umwandeln.
Wenn die Umwandlung fehlschlägt
Lässt sich das JSON nicht parsen, zeigt der Konverter Zeile und Spalte, einen Zeiger unter dem genauen Zeichen und was dort erwartet wurde. Übliche Ursachen sind ein Komma am Ende, einfache statt doppelte Anführungszeichen, ein Kommentar oder ein Schlüssel ohne Anführungszeichen. Der JSON-Validator listet Fehler in einem Durchgang auf, und der JSON-Formatierer macht die Struktur besser sichtbar. Beheben Sie die Syntax und konvertieren Sie dann erneut.
- Datei zu groß: Die kostenlosen Grenzen sind 10 MB für JSON zu YAML und 25 MB für YAML zu JSON. Teilen Sie die Datei oder nutzen Sie Pro.
- Mehrere Dateien auf einmal: Kostenlos wird jeweils eine Datei umgewandelt. Pro reiht bis zu 50 ein und lädt sie als ein ZIP herunter; YAML zu JSON kann außerdem alle Dokumente aller Dateien in einem Array zusammenführen.
- Doppelte Schlüssel in YAML: Standardmäßig wird abgelehnt und der zweite Schlüssel genannt. JSON kann nicht beide enthalten, wählen Sie also Letzten behalten nur, wenn Sie wissen, welchen Wert Sie wollen.
- Ein anderer Wert nach der Umwandlung: Die Meldung Prüfung fehlgeschlagen nennt den Pfad und beide Typen, zum Beispiel einen String, der als Datum zurückkam. Stellen Sie den Ziel-Parser auf Portabel.
Häufige Fragen
Wie wandle ich JSON in YAML um?
Fügen Sie Ihr JSON in den JSON-zu-YAML-Konverter ein, wählen Sie einen Ziel-Parser (Portabel ist voreingestellt) und klicken Sie auf In YAML konvertieren. Laden Sie dann die .yaml-Datei herunter oder kopieren Sie sie. Kostenlos geht eine Datei bis 10 MB.
Wie wandle ich YAML in JSON um?
Fügen Sie YAML ein oder ziehen Sie eine .yaml- oder .yml-Datei in den YAML-zu-JSON-Konverter. Wählen Sie den Einzug, den Umgang mit mehreren Dokumenten und ob Schlüssel sortiert werden, und laden Sie das Ergebnis herunter. Kostenlos geht eine Datei bis 25 MB.
Was ist das Norwegen-Problem in YAML?
In YAML 1.1 ist das Wort no ohne Anführungszeichen ein Boolean, daher wird der Ländercode NO für Norwegen als false gelesen. Das Quotieren des Werts behebt es. Der JSON-zu-YAML-Konverter übernimmt das, wenn der Ziel-Parser Portabel ist.
Bleiben Kommentare erhalten, wenn ich YAML in JSON umwandle?
Nein. JSON kennt keine Kommentare, daher fällt jeder #-Kommentar weg. Behalten Sie das YAML als Quelle und erzeugen Sie das JSON daraus, statt das JSON von Hand zu bearbeiten.
Warum scheitert mein YAML mit einem Tab-Fehler?
YAML erlaubt keine Tabs für die Einrückung, auch wenn die Datei in Ihrem Editor ausgerichtet aussieht. Ersetzen Sie die Tabs durch Leerzeichen. Der YAML-zu-JSON-Konverter nennt Zeile und Spalte, an der er gestoppt hat.
Kann ich Kubernetes- oder Docker-Compose-Dateien umwandeln?
Ja. Ein Manifest mit mehreren, durch --- getrennten Dokumenten wird zu einem Array, zu seinem ersten Dokument oder zu einer Datei pro Dokument. Anker, Aliasse und Merge-Schlüssel werden aufgelöst. Alles läuft auf Ihrem Gerät, nicht auf unseren Servern, sodass Hostnamen und Image-Namen nicht hochgeladen werden.