So verwenden Sie es
- Fügen Sie Ihr YAML in YAML-Text ein.
- Lesen Sie Gültigkeit ab. Nennt das Feld Zeile und Spalte, korrigieren Sie das YAML an dieser Stelle.
- Enthält das YAML mehrere Dokumente, ist der JSON-Text ein Array mit einem Eintrag für jedes Dokument.
- Kopieren Sie den JSON-Text oder laden Sie ihn als data.json herunter.
So wird das YAML gelesen
YAML 1.2 ist in einer Spezifikation festgelegt, die regelt, wie Einrückung, Namen, Listen, Anführungszeichen und Blöcke gelesen werden. Der Rechner liest den Text mit der Bibliothek yaml, die dieser Spezifikation folgt, und schreibt das Ergebnis als JSON.
- Eine Abbildung wird zu einem JSON-Objekt, mit den Namen in der Reihenfolge, in der sie geschrieben sind. Eine Sequenz wird zu einem Array. Die Wörter true, false und null werden zu Wahrheitswerten und null, während Text in Anführungszeichen Text bleibt.
- Eine ganze Zahl behält jede Ziffer. Ein doppelter Name in einer Abbildung wird als Fehler gemeldet, weil JSON nur einen seiner Werte behalten würde.
- Ein Wert wie .inf oder .nan hat keine JSON-Form. Er wird abgelehnt, statt als null oder als veränderte Zahl geschrieben zu werden.
Mehrere Dokumente und Aliase
Eine YAML-Datei kann mehrere Dokumente enthalten, jedes beginnt mit einer Zeile aus ---. Der Rechner liest alle. Ein Dokument ergibt einen JSON-Wert, mehrere ergeben ein JSON-Array mit einem Eintrag je Dokument, in der Reihenfolge des Auftretens. Ein Alias (*name) wird durch den Wert ersetzt, auf den er zeigt. Eine Datei, die einen Alias so oft wiederholt, dass das Ergebnis extrem groß würde, wird abgelehnt.
Rechenbeispiel: eine Datei mit zwei Dokumenten
Beispiel 2.7 aus der Spezifikation YAML 1.2 (Two Documents in a Stream) enthält eine Liste von Homerun-Schlägern, dann eine Zeile mit ---, dann eine Liste von Mannschaften. Umgewandelt ergibt das ein JSON-Array aus zwei Arrays, je eines für jedes Dokument.
Das erste Array enthält die drei Spieler, das zweite die beiden Mannschaften, in der Reihenfolge, in der sie geschrieben sind.
| Dokument | JSON-Eintrag |
|---|---|
| 1 | ["Mark McGwire", "Sammy Sosa", "Ken Griffey"] |
| 2 | ["Chicago Cubs", "St Louis Cardinals"] |
Häufig gestellte Fragen
Warum zeigt der Fehler eine Zeile und eine Spalte?
Die Stelle ist die Position, an der der Parser das Problem bemerkt, gezählt ab 1. Der eigentliche Fehler kann etwas früher liegen, etwa eine falsche Einrückung in der Zeile davor.
Was bedeutet der Hinweis zu mehreren Dokumenten?
Jede Zeile, die mit --- beginnt, startet ein neues Dokument. Das JSON ist dann ein Array mit einem Eintrag je Dokument, in der Reihenfolge der Datei. Wollten Sie nur ein Dokument, entfernen Sie die zusätzliche Zeile mit ---.
Warum gibt .inf oder .nan einen Fehler?
JSON kennt weder Unendlich noch Nicht-Zahl, daher lässt sich ein solcher Wert nicht ohne Veränderung schreiben. Ersetzen Sie ihn durch eine Zahl oder durch Text und wandeln Sie das YAML erneut um.
Werden Zahlen bei der Umwandlung verändert?
Ganze Zahlen behalten jede Ziffer, daher wird 12345678901234567890 genau geschrieben. Eine Dezimalzahl wird als nächste JavaScript-Zahl geschrieben, daher wird 1.50 zu 1.5 mit demselben Wert.
Behält das JSON die Reihenfolge der Namen?
Ja. Die Namen erscheinen in der Reihenfolge, in der sie im YAML stehen. Ein JavaScript-Objekt würde einen Namen wie 2024 nach vorn sortieren, dieser Rechner tut das nicht.
Wird mein YAML irgendwohin hochgeladen?
Nein. Die Umwandlung läuft in Ihrem Browser, und was Sie einfügen, wird nicht an einen Server gesendet.
Quellen
- YAML Ain't Markup Language (YAML) Revision 1.2.2 (englisch)
- RFC 8259 (englisch): The JavaScript Object Notation (JSON) Data Interchange Format
- yaml, die JavaScript-Bibliothek des Rechners (englisch)
Zahlen und Text zuletzt geprüft: Dienstag, 10. November 2026.