PK Systems PK Systems
Entwickler-Tools

JSON ↔ YAML Konverter

Konvertieren Sie in beide Richtungen zwischen JSON und YAML — mit Beibehaltung von Reihenfolge, Kommentaren und Anker-Referenzen.

JSON ↔ YAML Konverter

Ausgabe

Klicke auf „Konvertieren“, um die Umwandlung zu starten.

Wofür ist YAML gut?

YAML ist der freundlichere Verwandte von JSON: dasselbe Datenmodell (Objekte, Arrays, Strings, Zahlen, Booleans, null), aber mit signifikanter Whitespace-Einrückung statt geschweifter Klammern und eckiger Klammern, plus Kommentar-Unterstützung. Damit ist YAML das dominante Format für von Hand bearbeitete Konfigurationsdateien — Kubernetes-Manifeste, Helm-Values, GitHub-Actions-Workflows, CI-Pipelines, Docker Compose, Ansible-Playbooks und die meisten modernen App-Configs liegen alle in YAML vor. JSON dagegen dominiert Wire-Formate und APIs, weil jede Sprache es ohne nachzudenken parsen kann. Dieser Konverter lässt dich zwischen beiden hin- und herspringen, ohne den Browser zu verlassen. JSON → YAML nutzt du, wenn du eine API-Antwort in ein Kubernetes-Manifest verwandeln willst, oder wenn du eine Postman-Collection für ein Tutorial neu formatierst. YAML → JSON nutzt du, wenn ein Tool auf JSON besteht und deine Config in YAML vorliegt, oder wenn du eine YAML-Datei gegen ein JSON-Schema validieren möchtest. Alles wird direkt in deinem Browser-Tab konvertiert — kein Upload, kein Logging, keine Kopie deiner Manifeste auf fremden Servern. Das macht das Tool selbst für produktionsreife Helm-Values oder Workflow-Dateien sicher, die interne Hostnamen, Secret-Referenzen und Infrastrukturdetails enthalten.

So funktioniert es

Wähle eine Richtung, füge deine Daten ein, klicke auf Konvertieren. Das Ergebnis erscheint darunter mit einem Kopier-Button.

  1. Richtung wählen — Nutze JSON → YAML, um API-Antworten oder generierte Configs in etwas zu verwandeln, das Menschen bearbeiten können. Nutze YAML → JSON, wenn ein Tool JSON benötigt oder du eine YAML-Config an eine HTTP-API senden willst.
  2. Ein Preset ausprobieren — Klicke auf Kubernetes-Service, GitHub Action oder App-Config, um ein repräsentatives Beispiel zu laden, das du bearbeiten und konvertieren kannst. Das Preset passt zu deiner aktuellen Richtung.
  3. Einrückung wählen — 2 Leerzeichen sind das, was die meisten YAML-Linter und Ökosystem-Tools erwarten (Kubernetes, Ansible, Helm). Verwende 4 Leerzeichen nur, wenn dein Team sich ausdrücklich darauf festgelegt hat.
  4. Schlüssel sortieren für stabile Diffs — Aktiviere Schlüssel A→Z sortieren, um die Ausgabe alphabetisch zu ordnen. Das ist großartig für git-Diffs und Snapshot-Tests, wenn zwei Tools dieselben Daten in unterschiedlicher Schlüsselreihenfolge ausgeben.

Mapping-Regeln zwischen den Formaten

Beide Formate teilen sich dasselbe logische Modell, daher rundlaufen die meisten Werte identisch. Strings, Zahlen, Booleans, null, Arrays und Objekte werden eins-zu-eins abgebildet. Der Konverter folgt der modernen YAML-1.2-Spezifikation, die (anders als YAML 1.1) nicht yes, no, on, off als Booleans behandelt — nur true und false — sodass du das legendäre „Norwegen-Problem“ vermeidest, bei dem der Ländercode NO heimlich zum Boolean false wird. Mehrzeilige Strings nutzen in YAML literal- (|) oder gefaltete (>) Blöcke; bei der Konvertierung von JSON gibt dieses Tool aus Portabilitätsgründen reguläre, in Anführungszeichen gesetzte Strings mit \n-Escapes aus. Kommentare existieren nur in YAML; ein Round-Trip JSON → YAML → JSON verwirft Kommentare, weil JSON keinen Platz dafür hat.

Schnellreferenz

Eine Handvoll Werte und wie sie zwischen den beiden Formaten übersetzt werden.

JSON YAML
{ "a": 1 }a: 1
[1, 2, 3]- 1
- 2
- 3
"yes"'yes' (in Anführungszeichen, damit es ein String bleibt)
nullnull (oder leer / ~)
"line\nbreak""line\nbreak"
{ "n": 1.0 }n: 1.0 (bleibt ein Float)

Häufig gestellte Fragen

Warum wird mein YAML-String „true“ als Boolean angezeigt?

YAML behandelt unzitierte true und false als Booleans. Wenn du den wörtlichen vier-Zeichen-String möchtest, setze ihn in Anführungszeichen: flag: "true". Der Konverter respektiert genau das, was du geschrieben hast.

Verarbeitet er Mehrdokument-YAML-Dateien?

YAML unterstützt mehrere Dokumente in einer Datei, getrennt durch ---. Dieser Konverter parst beim Übergang nach JSON nur das erste Dokument. Bei Kubernetes-Manifest-Bundles teile deine Datei vor dem Einfügen auf oder konvertiere jedes Dokument einzeln.

Warum fehlen meine YAML-Kommentare nach dem Round-Trip?

JSON unterstützt keine Kommentare. Beim Übergang YAML → JSON werden alle Kommentare verworfen. Der Rückweg JSON → YAML kann sie nicht wiederherstellen. Bewahre eine Kopie des YAML auf, falls dir Kommentare wichtig sind.

Ist die Konvertierung für typische Configs verlustfrei?

Für Kubernetes, GitHub Actions, Docker Compose und ähnliche Configs — ja, mit dem einzigen Verlust bei Kommentaren und dem konkreten Stil mehrzeiliger Strings. Zahlen, als ISO-Strings geparste Daten, Booleans, verschachtelte Maps und Arrays runden sauber durch.

Was ist mit Anchors und Aliases (&ref / *ref)?

Anchors und Aliases werden beim Parsen aufgelöst, sodass die JSON-Ausgabe die materialisierten Werte enthält, auf die das YAML verwiesen hat. Die umgekehrte Richtung führt Anchors nicht automatisch wieder ein — wenn du dich darauf verlässt, um DRY-Configs kurz zu halten, musst du sie nach der Rückkonvertierung in YAML von Hand wieder einfügen.

Wird etwas an einen Server gesendet?

Nein. Die gesamte Konvertierung läuft komplett in deinem Browser-Tab, sodass das eingefügte YAML oder JSON — einschließlich Produktionsmanifesten, Secret-Referenzen und internen Infrastrukturnamen — niemals unsere Server oder Dritte erreicht.