Methodik

Methodik und Quellen

jsonyaml.de wandelt JSON und YAML lokal im Browser ineinander um. Die Umwandlung läuft komplett auf Deinem Gerät, kein Server sieht Deine Daten. Diese Seite erklärt, wie das Tool intern arbeitet und worauf wir achten.

Die Konvertierungs-Pipeline

Für die JSON-Seite nutzen wir die eingebauten Browser-Funktionen JSON.parse und JSON.stringify. Für die YAML-Seite kommt die etablierte Bibliothek js-yaml zum Einsatz, die dem YAML-1.2-Standard folgt. Der Ablauf hängt von der gewählten Richtung ab:

• JSON zu YAML: Dein Text wird streng mit JSON.parse gelesen und anschließend über dump() als YAML ausgegeben. Referenzen werden dabei ausgeschrieben statt als Anchor gesetzt, und lange Zeilen werden nicht umgebrochen.
• YAML zu JSON: Dein Text wird mit loadAll() sicher geladen und danach über JSON.stringify mit der gewählten Einrückung als JSON ausgegeben.

Der Richtungs-Umschalter

Über den Umschalter in der Steuerleiste wechselst Du zwischen beiden Richtungen. War die aktuelle Ausgabe fehlerfrei, übernimmt das Tool sie beim Umschalten als neue Eingabe, so lassen sich Formate bequem hin und her wandeln. Welches Format wann sinnvoll ist, klärt der Ratgeber Wann YAML statt JSON.

Einrückung und Reihenfolge

Du wählst zwei oder vier Leerzeichen Einrückung. Die Reihenfolge der Schlüssel bleibt in beide Richtungen erhalten, das Tool sortiert nichts um. So bleibt Deine Ausgabe nah an der Eingabe und ist in der Versionsverwaltung gut vergleichbar. Details zur YAML-Schreibweise stehen im Ratgeber YAML-Syntax verstehen.

Mehrere Dokumente und Anchor

Enthält Deine YAML-Eingabe mehrere durch --- getrennte Dokumente, fasst das Tool sie beim Umwandeln in ein JSON-Array zusammen. YAML-Anchor und Alias werden aufgelöst, weil JSON keine Referenzen kennt. Was den Formatwechsel sonst nicht überlebt, etwa Kommentare, steht im Ratgeber Fallstricke beim Konvertieren.

Fehleranzeige statt falschem Ergebnis

Ist die Eingabe ungültig, liefert das Tool kein stilles Falschergebnis, sondern zeigt die Fehlermeldung an. Bei YAML-Fehlern nennt js-yaml zusätzlich die Zeilennummer, die wir übernehmen und einblenden. So findest Du die Problemstelle schnell.

Grenzen der Umwandlung

Die folgende Tabelle fasst zusammen, welche Eigenschaften erhalten bleiben und welche nicht.

Privacy-Architektur

Wir verarbeiten Deine Daten nur lokal im Browser. Der Text wird geparst, in die Zielstruktur überführt und als String zurückgegeben. Es gibt keinen fetch an unsere Server, keine Hintergrund-Synchronisation, kein Logging Deiner Inhalte. Im DevTools Netzwerk-Tab siehst Du genau das. Gerade bei Konfigurationsdateien mit Schlüsseln oder Geheimnissen ist das ein Vorteil, den der Ratgeber Datenschutz bei Daten-Konvertern einordnet.

Was wir an Telemetrie sehen

Wenn Du dem Cookie-Banner zustimmst, lädt unser Tool zwei Drittanbieter-Skripte: Adition (Werbung) und optional Umami (cookielose Reichweitenmessung). Beide sehen nichts über Deine Daten, weil diese den Browser nie verlassen. Sie sehen den Seitenaufruf, die Verweildauer und grobe Geräte-Daten.

Quellen

• YAML Specification 1.2.2 (Aufbau, Datentypen, Anchor und Alias).
• js-yaml (die verwendete YAML-Bibliothek, load und dump).
• MDN: JSON (JSON.parse und JSON.stringify).
• RFC 8259: JSON (der JSON-Standard).

Review-Zyklus

Die Ratgeber und Pflicht-Pages werden halbjährlich gegen aktuelle Quellen geprüft. Änderungen landen mit Datum und Begründung unter /korrekturen. Tippfehler und kleinere Präzisierungen machen wir still im Hintergrund.

Was jsonyaml.de NICHT ist

jsonyaml.de ist kein Editor und kein Validierungs-Framework mit Schema-Prüfung. Wir wandeln zwischen den Formaten, steuern die Einrückung und melden Syntaxfehler. Prüfungen gegen ein JSON-Schema, Formatierungs-Linting oder das Auflösen von Umgebungsvariablen gehören nicht dazu. Dafür sind spezialisierte Werkzeuge wie json-validator.de oder yamllint besser geeignet.