Sprache auswählen

YAML zu JSON Konverter

Wandle YAML in gültiges JSON um: erkennt Einrückungen, verschachtelte Strukturen, Anker und Aliase und zeigt das Ergebnis sofort formatiert an.

Mehmet Demiray Veröffentlicht Aktualisiert
Teilen
YAML-Merge-Schlüssel (<<) in die Abbildung expandieren
Leerzeichen zur Formatierung der JSON-Ausgabe

Warum YAML in JSON umwandeln

YAML und JSON beschreiben dieselbe Welt aus verschachtelten Schlüssel-Wert-Paaren, Listen und Skalaren, nur mit anderer Schreibweise. YAML setzt auf Einrückung und verzichtet auf Klammern, was Menschen das Lesen erleichtert. JSON nutzt geschweifte und eckige Klammern, Anführungszeichen und Kommata und ist damit für Maschinen eindeutiger.

In der Praxis liegt eine Konfiguration oft als YAML vor, weil sie von Hand gepflegt wird. Eine Schnittstelle, eine Bibliothek oder ein Dienst erwartet jedoch JSON. Genau hier setzt die Umwandlung an: Du behältst die lesbare Quelle und erzeugst bei Bedarf das maschinenfreundliche Format.

Typische Auslöser sind:

  • Eine REST-Schnittstelle akzeptiert ausschließlich JSON im Anfragetext.
  • Ein Werkzeug versteht nur JSON, deine Vorlagen sind aber in YAML geschrieben.
  • Du möchtest eine YAML-Datei prüfen, indem du ihr JSON-Gegenstück betrachtest.

Die strukturellen Unterschiede sind überschaubar, doch im Detail entscheiden Einrückung, Datentypen und Sonderzeichen über das Ergebnis. Ein verlässlicher Konverter nimmt dir diese Feinarbeit ab und liefert in Sekunden gültiges JSON.

So arbeitet der Konverter

Die Umwandlung läuft in drei Schritten ab. Zuerst liest der Konverter deinen YAML-Text ein und baut daraus einen internen Baum aus Objekten, Listen und Skalaren. Dabei wertet er die Einrückung aus, die in YAML die Verschachtelung bestimmt.

Im zweiten Schritt wird dieser Baum auf die JSON-Struktur abgebildet. Aus einem YAML-Mapping wird ein JSON-Objekt, aus einer Sequenz ein Array, und Skalare werden zu Zeichenketten, Zahlen, Wahrheitswerten oder null. Anker und Aliase werden aufgelöst, sodass referenzierte Blöcke im JSON vollständig ausgeschrieben erscheinen.

Zum Schluss erzeugt der Konverter formatiertes JSON mit klarer Einrückung, das du direkt kopieren kannst.

Einige Randfälle verdienen Aufmerksamkeit:

YAML JSON
aktiv: yes "aktiv": true
port: 8080 "port": 8080
wert: ~ "wert": null
Mehrzeiliger Block mit ` `

Mehrzeilige Texte behandelt der Konverter so, wie es die JSON-Regeln vorsehen. Kommentare entfallen, weil JSON sie nicht kennt.

Strukturelle Unterschiede im Detail

Wer YAML und JSON nebeneinanderlegt, erkennt schnell dieselbe Logik in zwei Gewändern. Ein kurzes Beispiel verdeutlicht das. In YAML notierst du eine Server-Konfiguration so:

`` server: host: localhost port: 8080 tags: - web - api ``

Das entsprechende JSON sieht so aus:

`` { "server": { "host": "localhost", "port": 8080, "tags": ["web", "api"] } } ``

Die Einrückung in YAML übernimmt die Aufgabe, die in JSON von Klammern erfüllt wird. Listen markierst du in YAML mit einem Bindestrich, in JSON mit eckigen Klammern. Schlüssel stehen in JSON immer in Anführungszeichen, in YAML meist ohne.

Wichtig ist die Behandlung von Datentypen. YAML interpretiert yes, no, on und off je nach Version als Wahrheitswerte. Zahlen ohne Anführungszeichen werden als Zahlen erkannt. Wenn du einen Wert ausdrücklich als Text behalten möchtest, setzt du ihn in YAML in Anführungszeichen. So bleibt etwa eine Postleitzahl mit führender Null im JSON eine Zeichenkette.

Typische Anwendungsfälle

Die Umwandlung von YAML in JSON begegnet dir in vielen Arbeitsabläufen. Drei Bereiche stechen besonders heraus.

Erstens die Arbeit mit Schnittstellen. Viele REST-Dienste erwarten JSON im Anfragetext. Wenn du Testdaten oder Beispielanfragen bequem in YAML pflegst, wandelst du sie vor dem Absenden in JSON um. Das Ergebnis kannst du anschließend mit einem JSON Formatter noch sauberer aufbereiten.

Zweitens die Migration von Konfigurationen. Wechselst du das Werkzeug oder die Plattform, ändert sich oft das erwartete Format. Eine bestehende YAML-Datei in JSON zu überführen spart das mühsame Abtippen und vermeidet Tippfehler.

Drittens der Datenaustausch zwischen Systemen. Ein Dienst liefert YAML, ein anderer verlangt JSON. Der Konverter sitzt als Brücke dazwischen.

Benötigst du den umgekehrten Weg, hilft dir der JSON zu YAML Konverter. Arbeitest du außerdem mit TOML-Dateien, eignet sich der TOML zu JSON Konverter. So deckst du die gängigen Formatwechsel mit einer kleinen Sammlung verlässlicher Werkzeuge ab.

Ist die Umwandlung verlustfrei

Die Frage nach Verlusten ist berechtigt, denn YAML kann Dinge ausdrücken, die JSON nicht kennt. In der Substanz ist die Umwandlung jedoch verlustfrei: Alle Schlüssel, Werte, Listen und verschachtelten Strukturen erscheinen vollständig im JSON.

Einige YAML-Eigenheiten haben in JSON kein direktes Gegenstück und werden daher aufgelöst oder weggelassen:

  • Kommentare entfallen, weil JSON keine Kommentare unterstützt.
  • Anker und Aliase werden ausgeschrieben, statt als Referenz erhalten zu bleiben.
  • Mehrzeilige Blöcke werden zu einer Zeichenkette mit eingebetteten Zeilenumbrüchen.

Diese Schritte verändern die Form, nicht den Inhalt. Die Daten selbst bleiben identisch. Wenn rund 20 % deiner YAML-Datei aus Kommentaren bestehen, fehlen diese Erläuterungen im JSON, die eigentlichen Werte sind aber alle vorhanden.

Wichtig ist die Eindeutigkeit der Quelle. Ist dein YAML korrekt eingerückt und frei von doppelten Schlüsseln, entsteht ein eindeutiges JSON. Bei Unklarheiten meldet der Konverter einen Fehler, statt stillschweigend zu raten, damit du die Stelle gezielt korrigieren kannst.

Die, die wir am häufigsten beantworten.

Wie wandle ich YAML in JSON um?

Füge deinen YAML-Text in das Eingabefeld ein. Der Konverter liest die Struktur, löst Anker und Aliase auf und erzeugt sofort formatiertes JSON. Das Ergebnis kannst du direkt kopieren und in deinem Projekt weiterverwenden.

Worin unterscheiden sich YAML und JSON?

YAML nutzt Einrückung und verzichtet auf Klammern, was es gut lesbar macht. JSON arbeitet mit geschweiften und eckigen Klammern, Anführungszeichen und Kommata und ist dadurch für Maschinen eindeutiger. Beide beschreiben dieselbe Logik aus Objekten, Listen und einfachen Werten.

Was passiert mit verschachtelten Strukturen und Sonderzeichen?

Verschachtelte Mappings und Sequenzen werden vollständig in JSON-Objekte und Arrays übersetzt, unabhängig von der Tiefe. Sonderzeichen in Werten werden korrekt maskiert, etwa Anführungszeichen oder Zeilenumbrüche. So bleibt das Ergebnis gültiges JSON.

Ist die Umwandlung verlustfrei?

Die eigentlichen Daten bleiben vollständig erhalten. Kommentare entfallen jedoch, weil JSON sie nicht kennt, und Anker werden ausgeschrieben statt als Referenz bewahrt. Inhaltlich ist das Ergebnis identisch, nur die YAML-spezifische Form geht verloren.

Wie werden Wahrheitswerte und Zahlen behandelt?

Ein nicht zitiertes yes oder true wird zu einem JSON-Wahrheitswert, eine reine Ziffernfolge zu einer Zahl. Möchtest du einen Wert als Text erhalten, etwa eine Postleitzahl mit führender Null, setze ihn in YAML in Anführungszeichen. Dann bleibt er im JSON eine Zeichenkette.

Brauche ich den umgekehrten Weg von JSON zu YAML?

Falls du JSON wieder in das lesbarere YAML überführen möchtest, nutze den JSON zu YAML Konverter. Für sauberes Einrücken von JSON eignet sich der JSON Formatter. Beide ergänzen diesen Konverter im Arbeitsalltag.