JSON-zu-YAML-Konverter
Wandeln Sie JSON-Arrays oder -Objekte in sauberes, lesbares YAML um. Fügen Sie JSON ein oder laden Sie es hoch, wählen Sie Block- oder Flow-Array-Stil, Einrückung und Anführungszeichen-Regeln, und kopieren oder laden Sie das Ergebnis herunter – alles direkt im Browser.
100% Client-seitige Verarbeitung
Ihr JSON wird vollständig in Ihrem Browser verarbeitet und konvertiert. Es wird nichts an einen Server gesendet.
Optionen
Inhaltsverzeichnis
Was ist ein JSON-zu-YAML-Konverter?
Ein JSON-zu-YAML-Konverter nimmt strukturierte JSON-Daten – ein Array von Objekten oder ein einzelnes Objekt – und schreibt sie als YAML („YAML Ain't Markup Language") um, das einrückungsbasierte Datenformat für Kubernetes-Manifeste, Docker-Compose-Dateien, CI/CD-Pipelines (GitHub Actions, GitLab CI, CircleCI), Ansible-Playbooks und unzählige Konfigurationsdateien von Anwendungen.
Der Konverter durchläuft die JSON-Struktur und ordnet jeden Schlüssel einem YAML-Mapping-Eintrag zu: Objektschlüssel werden zu „Schlüssel: Wert"-Zeilen, Arrays werden zu eingerückten Listeneinträgen (oder Inline-Flow-Listen), und Zeichenketten werden nur bei Bedarf automatisch in Anführungszeichen gesetzt – so entsteht sauberes, minimales YAML, das leicht zu lesen und sicher zu verarbeiten ist.
So funktioniert es
- JSON hinzufügen: Fügen Sie JSON direkt in den Editor ein oder laden Sie eine .json-Datei hoch.
- Optionen wählen: Legen Sie eine Einrückungsgröße fest, ob Arrays als Block-Listen oder als Inline-Flow-Listen dargestellt werden sollen, und ob String-Werte nur bei Bedarf oder immer in Anführungszeichen gesetzt werden sollen.
- Ergebnis sofort ansehen: Das Tool analysiert Ihr JSON im Browser und zeigt das konvertierte YAML während der Eingabe an, zusammen mit Zeilen- und Zeichenanzahl.
- Kopieren oder herunterladen: Kopieren Sie das YAML in die Zwischenablage oder laden Sie es als .yaml-Datei herunter.
Funktionen
- JSON einfügen oder eine .json-Datei hochladen
- Sofortige Live-Konvertierung während der Eingabe – ohne Klick auf eine Schaltfläche
- Funktioniert mit einem einzelnen JSON-Objekt oder einem Array von Objekten
- Block-Array-Stil (- Eintrag pro Zeile) oder Flow-Stil (inline [a, b, c])
- Intelligente automatische Anführungszeichen: Strings werden nur bei Bedarf in Anführungszeichen gesetzt (zahlenähnlich, reservierte Wörter, Sonderzeichen)
- Optionaler Modus „Strings immer in Anführungszeichen" für eine strengere, explizitere Ausgabe
- Konfigurierbare Einrückung (2, 4 oder 8 Leerzeichen – YAML verbietet Tabulatoren zur Einrückung, daher keine Tab-Option)
- Verschachtelt Objekte in Arrays und Arrays in Arrays korrekt
- Leere Arrays und Objekte werden als [] und {} dargestellt statt weggelassen
- Live-Zeilen- und Zeichenanzahl
- 100% clientseitige Verarbeitung für Ihre Privatsphäre
Bewährte Praktiken
- Lassen Sie die Anführungszeichen-Einstellung auf „Automatisch", sofern kein Grund dagegenspricht: die automatische Einstellung hält das Ergebnis lesbar und setzt trotzdem sicher Anführungszeichen bei allem Mehrdeutigen, etwa einer Zeichenkette, die wie eine Zahl, ein Boolean oder das Wort „null" aussieht.
- Verwenden Sie den Flow-Stil für kurze Listen einfacher Werte: eine Liste von Tags oder IDs liest sich oft besser als eine einzelne Inline-Zeile denn als mehrere Block-Einträge – der Flow-Stil gilt nur für Arrays aus einfachen Werten und wechselt automatisch zum Block-Stil, wenn das Array Objekte oder verschachtelte Arrays enthält.
- Achten Sie auf zahlenähnliche Zeichenketten, die Text bleiben müssen: Werte wie Postleitzahlen, Telefondurchwahlen oder IDs mit führender Null (z. B. „007") werden automatisch in Anführungszeichen gesetzt, damit ein YAML-Parser sie nicht als Zahlen fehlinterpretiert.
- Prüfen Sie Schlüssel und Werte mit Doppelpunkt genau: ein Wert wie „Winner: Best Programmer" wird automatisch in Anführungszeichen gesetzt, da eine ungeschützte Doppelpunkt-Leerzeichen-Folge sonst als verschachteltes Mapping gelesen würde.
- Gegen den YAML-Dialekt Ihres Zieltools validieren: die meisten Tools (Kubernetes, GitHub Actions, Docker Compose) akzeptieren das hier erzeugte Standard-YAML 1.1/1.2, aber lassen Sie das Ergebnis immer durch den Validator oder Trockenlauf-Modus Ihres Zielsystems laufen, bevor Sie sich in der Produktion darauf verlassen.
Fehlerbehebung
Es heißt, mein JSON sei ungültig
Prüfen Sie auf ein überzähliges Komma nach dem letzten Element eines Arrays oder Objekts, Schlüssel ohne Anführungszeichen, einfache statt doppelte Anführungszeichen oder eine nicht geschlossene Klammer – das sind die häufigsten Gründe, warum JSON nicht analysiert werden kann.
Ein String-Wert kam in Anführungszeichen heraus, obwohl ich das nicht erwartet hatte
Das ist beabsichtigt und sicher: Zeichenketten, die wie Zahlen, Booleans oder die Wörter null/true/false/yes/no (in beliebiger Groß-/Kleinschreibung) aussehen, werden automatisch in Anführungszeichen gesetzt, damit ein YAML-Parser sie als Zeichenketten liest, nicht als diese Typen.
Mein Array aus Objekten wurde nicht zu einer Flow-Liste
Der Flow-Stil ([a, b, c]) gilt nur für Arrays, die ausschließlich aus einfachen Werten bestehen (Zeichenketten, Zahlen, Booleans, null). Arrays mit Objekten oder verschachtelten Arrays verwenden immer den Block-Stil (mehrzeilig), da Inline-Objekte deutlich schwerer zu lesen sind.
Es gibt keine „Tabulator"-Einrückungsoption
Die YAML-Spezifikation erlaubt keine echten Tabulatorzeichen zur Einrückung – nur Leerzeichen sind gültig. Deshalb bietet dieses Tool nur 2, 4 oder 8 Leerzeichen an, keine Tabulatoren.
Häufige Anwendungsfälle
- Kubernetes-Manifeste schreiben: konvertieren Sie ein JSON-Objekt, das ein Deployment, einen Service oder ein ConfigMap beschreibt, in das von kubectl erwartete YAML-Format.
- CI/CD-Pipeline-Dateien erzeugen: wandeln Sie eine in JSON definierte Pipeline-Konfiguration in das von GitHub Actions, GitLab CI oder CircleCI benötigte YAML-Format um.
- Anwendungskonfiguration migrieren: konvertieren Sie eine JSON-Konfigurationsdatei zu YAML für Tools und Frameworks (Docker Compose, Ansible, Spring Boot), die YAML bevorzugen oder erfordern.
- API-Antworten in einem lesbaren Format dokumentieren: das Fehlen von Klammern und Anführungszeichen bei den meisten Werten macht YAML in der Dokumentation leichter lesbar als rohes JSON.
- YAML-verarbeitenden Code testen: erzeugen Sie schnell Beispiel-YAML-Payloads aus JSON-Testdaten, ohne YAML von Hand zu schreiben.
Häufig gestellte Fragen
Ja. Ein einzelnes Objekt wird direkt zu einem YAML-Mapping. Ein Array auf oberster Ebene wird zu einer YAML-Block-Sequenz, wobei jeder Eintrag zu einem Listenelement wird.
Der Block-Stil schreibt einen Array-Eintrag pro Zeile mit einem vorangestellten Bindestrich – der YAML-Standardstil, am besten lesbar. Der Flow-Stil schreibt das Array inline in eckigen Klammern, wie [a, b, c] – kompakter, wird hier aber nur für Arrays aus einfachen Werten verwendet, nie für Arrays aus Objekten.
Bei der Standardeinstellung „Automatisch" wird eine Zeichenkette nur dann in Anführungszeichen gesetzt, wenn sie ohne diese ihre Bedeutung ändern würde – etwa wenn sie wie eine Zahl aussieht („007"), wie ein Boolean („yes"), das Wort „null" ist, oder einen Doppelpunkt gefolgt von einem Leerzeichen enthält. Gewöhnliche Zeichenketten bleiben zur besseren Lesbarkeit ohne Anführungszeichen.
Ja. Stellen Sie „Anführungszeichen bei Strings" auf „Strings immer in Anführungszeichen", um jeden String-Wert in doppelte Anführungszeichen zu setzen, unabhängig davon, ob er sie benötigt.
Verschachtelte Objekte werden zu eingerückten YAML-Mappings. Verschachtelte Arrays und Arrays aus Objekten werden als Block-Sequenzen eingerückt, wobei der erste Schlüssel jedes Objekts in derselben Zeile wie sein Bindestrich steht.
Nein. Alles geschieht lokal in Ihrem Browser, nichts wird hochgeladen oder gespeichert.
Der Konverter läuft im Speicher Ihres Browsers, sodass sehr große JSON-Dateien (mehrere zehn Megabyte oder mehr) je nach Gerät langsam sein oder viel Speicher verbrauchen können.