JSON in YAML umwandeln: Einrückung und Schlüsselsortierung einstellen

Wofür sich die JSON-zu-YAML-Umwandlung eignet

Mit diesem Konverter überträgst du gültigen JSON-Text in YAML im Blockstil. Das ist hilfreich, wenn eine strukturierte Darstellung mit eingerückten Ebenen und Listenmarkierungen für den nächsten Arbeitsschritt übersichtlicher sein soll. Verarbeitet werden JSON-Objekte, verschachtelte Objekte und Arrays. Du kannst dabei festlegen, wie stark verschachtelte Ebenen eingerückt werden, und die Schlüssel von Zuordnungen nach Wunsch sortieren.

Die Einstellungsmöglichkeiten betreffen die Darstellung der erzeugten YAML-Ausgabe. Die Einrückung legt den Abstand zwischen einer übergeordneten Ebene und ihren untergeordneten Einträgen fest. Die optionale Sortierung verändert dagegen die Reihenfolge der Zuordnungsschlüssel. So kannst du die Ausgabe an deine bevorzugte Lesereihenfolge anpassen, ohne die Eingabe selbst als YAML zu verfassen.

Für die Umwandlung brauchst du JSON-Text als Ausgangspunkt. Eine Eingabe ist jedoch nicht zwingend erforderlich: Ein leeres Feld oder eine Eingabe, die nur aus Leerzeichen besteht, wird ebenfalls akzeptiert und führt zu einer erfolgreichen Umwandlung mit leerem YAML-Text. Dieser Sonderfall unterscheidet sich von Text, der zwar vorhanden, aber syntaktisch kein gültiges JSON ist.

Eingabe, Optionen und Konvertierung durchführen

1. Füge den JSON-Text in das Eingabefeld ein. Achte darauf, dass Eigenschaftsnamen und Textwerte in doppelten Anführungszeichen stehen und dass Objekte sowie Arrays mit passenden Klammern abgeschlossen sind. Auch wenn du nichts einfügst, kannst du die Konvertierung starten; ein leeres oder nur aus Leerzeichen bestehendes Feld wird als zulässige Eingabe behandelt.

2. Wähle die gewünschte Einrückung. Wenn du keine eigene Zahl festlegst, verwendet das Tool standardmäßig 2. Eine kleinere oder größere Einstellung verändert den Abstand in verschachtelten Bereichen der Darstellung, nicht den JSON-Inhalt, den du als Ausgangstext eingegeben hast.

3. Entscheide, ob die Schlüssel von Zuordnungen sortiert werden sollen. Diese Option ist zunächst ausgeschaltet. Aktiviere sie, wenn die Schlüssel in der erzeugten Darstellung sortiert erscheinen sollen; lasse sie deaktiviert, wenn die vorhandene Reihenfolge für deine Lesekontrolle maßgeblich ist.

4. Starte die Umwandlung und lies den erzeugten YAML-Text. Gültige JSON-Objekte, verschachtelte Objekte und Arrays werden in eine YAML-Darstellung übertragen. Die Ausgabe verwendet den Blockstil. Bei nicht leeren Arrays weist du Listen an den ausgegebenen Listenmarkierungen aus. Zeichen außerhalb des ASCII-Zeichensatzes bleiben erhalten, während Zeichenfolgen mit für YAML relevanter Syntax in Anführungszeichen erscheinen können.

5. Vergleiche bei Bedarf die Struktur der Ausgabe mit deiner Eingabe. Prüfe besonders verschachtelte Ebenen, Listen und die Reihenfolge der Schlüssel, wenn du die Sortieroption verwendet hast. Enthält der eingegebene Text kein gültiges JSON, ist die Umwandlung nicht erfolgreich und es wird kein YAML-Text erzeugt. Ein Fehler beim Erzeugen der YAML-Ausgabe wird ebenfalls als nicht erfolgreiche Umwandlung behandelt.

Den Ausgabestatus und die Struktur einordnen

Eine erfolgreiche Ausgabe zeigt, dass aus dem eingegebenen gültigen JSON-Text YAML-Text erzeugt wurde. Bei einer leeren oder aus Leerzeichen bestehenden Eingabe besteht der erfolgreiche Inhalt aus leerem YAML-Text; daraus sollte keine Objekt- oder Listenstruktur abgeleitet werden. Bei einem Objekt erkennst du die Zuordnungen im Blockstil, bei einem nicht leeren Array die dafür verwendeten Listenmarkierungen.

Die eingestellte Einrückung hilft dir dabei, Ebenen visuell voneinander zu unterscheiden. Sie ist deshalb vor allem für verschachtelte Strukturen relevant. Eine aktivierte Schlüsselsortierung betrifft die Reihenfolge der Zuordnungsschlüssel in der Darstellung. Wenn die Option ausgeschaltet bleibt, wird keine zusätzliche Sortierung durch diese Einstellung verlangt.

Kein erzeugter YAML-Text weist bei dieser Umwandlung auf eine nicht erfolgreiche Verarbeitung hin, sofern keine leere Eingabe vorlag. Kontrolliere dann zuerst, ob der Ausgangstext gültiges JSON bildet. Auch ein Fehler während der YAML-Serialisierung endet mit einem nicht erfolgreichen Ergebnis. Die Konvertierung ist daher nicht mit einer Zusicherung gleichzusetzen, dass jedes ursprüngliche Formatdetail unverändert erhalten bleibt.

Praktisches Beispiel

Du möchtest ein kleines Objekt mit einem Namen und einer Tag-Liste in eine übersichtliche YAML-Struktur übertragen.

Gib den JSON-Text {"name":"Mira","tags":["rot","blau"]} ein, lasse die voreingestellte Einrückung bestehen, aktiviere die Schlüsselsortierung nach Bedarf und starte die Umwandlung.

Die erfolgreiche Ausgabe enthält eine YAML-Zuordnung für „name“ sowie eine nicht leere Liste mit Listenmarkierungen für „tags“. Die Reihenfolge der Zuordnungsschlüssel kann von der gewählten Sortieroption abhängen.

Einschränkungen

• Ungültiger JSON-Text oder ein Fehler beim Erzeugen der YAML-Ausgabe führt zu einer nicht erfolgreichen Umwandlung ohne erzeugten YAML-Text.

Häufige Fehler

• Ursache: Der Ausgangstext enthält ungültige JSON-Syntax, beispielsweise ein fehlendes Komma oder falsch gesetzte Anführungszeichen. Korrigiere die Klammern, Kommas und Wertschreibweisen und starte die Umwandlung danach erneut.

Häufige Fragen

Kann ich die Umwandlung ohne JSON-Text starten?

Ja, sofern das Feld leer bleibt oder nur Leerzeichen enthält. Dieser Fall wird erfolgreich verarbeitet, wobei der erzeugte YAML-Text leer ist.

Lassen sich Einrückung und Schlüsselsortierung getrennt einstellen?

Ja. Für die Einrückung gilt standardmäßig 2, und die Sortierung der Zuordnungsschlüssel lässt sich unabhängig davon aktivieren.

Was geschieht bei ungültigem JSON?

Dann ist die Konvertierung nicht erfolgreich, und es wird kein YAML-Text erzeugt. Überprüfe die JSON-Syntax, bevor du den Vorgang erneut startest.