Werkzeuge
Blog Home

Kostenloser YAML Formatter & Validator online

Formatieren, validieren und verschönern Sie YAML im Browser und konvertieren Sie zwischen YAML und JSON. Funktioniert mit Docker-Compose-, Kubernetes- und GitHub-Actions-Konfigurationen. Nichts wird jemals an einen Server gesendet.

Sämtliches Parsen und Konvertieren erfolgt lokal in Ihrem Browser. Ihr YAML und JSON wird niemals hochgeladen, gespeichert oder protokolliert.

Was ist YAML?

YAML (YAML Ain't Markup Language) ist ein menschenlesbares Datenserialisierungsformat, das leicht zu schreiben und zu lesen ist. Seine klare, auf Einrückung basierende Syntax hat XML in vielen modernen Konfigurationsdateien ersetzt und treibt Werkzeuge wie Docker Compose, Kubernetes, GitHub Actions, Ansible und Helm an. YAML ist außerdem eine Obermenge von JSON, sodass jedes gültige JSON-Dokument auch gültiges YAML ist – das macht die Konvertierung zwischen beiden Formaten für die meisten alltäglichen Konfigurationsdaten unkompliziert und verlustfrei.

YAML-Syntaxleitfaden

key: value Skalare — ein einfaches Schlüssel/Wert-Paar. Mehrzeilige Zeichenketten nutzen | (wörtlich, behält Zeilenumbrüche) oder > (gefaltet, verbindet Zeilen).
- item Listen — jedes Element in einer eigenen Zeile, eingeleitet von einem Bindestrich und einem Leerzeichen.
parent: child: x Verschachtelte Dictionaries — drücken die Hierarchie ausschließlich über die Einrückung aus.
# comment Kommentare — alles nach einem # wird vom Parser ignoriert.
null / true / false Spezielle Werte — null, true und false werden als typisierte Werte erkannt, nicht als Zeichenketten.
&anchor / *alias Anker & Aliase — definieren Sie einen Knoten einmal mit &anchor und verwenden Sie ihn mit *alias erneut.
Wichtig: YAML erlaubt keine Tabulatoren für die Einrückung, nur Leerzeichen. Ein einziger Tabulator macht das gesamte Dokument ungültig.

YAML vs. JSON: Wann welches

YAML

Verwenden Sie YAML für von Hand geschriebene und bearbeitete Konfigurationsdateien. Es unterstützt Kommentare, ist lesbarer und ist der Standard für Docker Compose, Kubernetes, GitHub Actions, Ansible und Helm.

JSON

Verwenden Sie JSON für APIs und Daten im Transit. Es wird schneller geparst, hat keine Typmehrdeutigkeit und ist das Format hinter REST-APIs, package.json und tsconfig.json.

Häufige YAML-Fehler und ihre Behebung

  1. Tabulatoren statt Leerzeichen für die Einrückung — ersetzen Sie jeden Tabulator durch Leerzeichen, da YAML Tabulatoren verbietet.
  2. Inkonsistente Einrückung — verwenden Sie im gesamten Dokument dieselbe Anzahl Leerzeichen pro Verschachtelungsebene.
  3. Eine Zeichenkette mit einem Doppelpunkt ohne Anführungszeichen — setzen Sie Werte wie "12:30" oder "http://example.com" in Anführungszeichen.
  4. Mehrdeutige Booleans — Werte wie yes, no, on und off werden als true/false interpretiert; setzen Sie sie in Anführungszeichen, wenn Sie die wörtlichen Wörter meinen.
  5. Sonderzeichen in einem Wert ohne Anführungszeichen — Zeichen wie @, # und { erfordern, dass der Wert in Anführungszeichen steht.

Häufig gestellte Fragen

Nein. YAML verbietet Tabulatorzeichen für die Einrückung strikt – Sie müssen Leerzeichen verwenden. Dies ist eine der häufigsten Ursachen für „ungültiges YAML“-Fehler. Wenn Ihr Editor Tabulatoren einfügt, konfigurieren Sie ihn so, dass er Tabulatoren in Leerzeichen umwandelt (in der Regel 2 pro Ebene). Der Formatter auf dieser Seite gibt immer Leerzeichen aus, sodass das Durchlaufen Ihrer Datei versehentliche Tabulatoren automatisch behebt.

Beide leiten mehrzeilige Zeichenketten ein, behandeln Zeilenumbrüche aber unterschiedlich. Der literale Block-Skalar | behält Zeilenumbrüche genau wie geschrieben, jede Zeile bleibt in ihrer eigenen Zeile – ideal für Skripte oder formatierten Text. Der gefaltete Block-Skalar > verbindet Zeilen mit Leerzeichen und reduziert den Block auf eine einzelne Zeile, wobei Leerzeilen als Absatzumbrüche behandelt werden – nützlich für langen Fließtext, den Sie in der Quelle umbrechen, aber als eine Zeile speichern möchten.

Ja. Seit YAML 1.2 ist jedes gültige JSON-Dokument auch ein gültiges YAML-Dokument, weil die Flow-Syntax von YAML dieselben geschweiften Klammern, eckigen Klammern und Anführungsregeln wie JSON verwendet. Sie können JSON also direkt in einen YAML-Parser einfügen, und es funktioniert. Das macht die Konvertierung zwischen beiden Formaten zuverlässig – genau das leisten die Tabs YAML zu JSON und JSON zu YAML auf dieser Seite.

YAML-Parser interpretieren eine Reihe von Wörtern – yes, no, on, off, true, false – als boolesche Werte. Der nicht in Anführungszeichen gesetzte Skalar yes wird daher als Boolean true gelesen und in JSON so serialisiert. Wenn Sie die wörtliche Zeichenkette "yes" benötigen (zum Beispiel einen Ländercode oder ein Antwortfeld), setzen Sie sie in Anführungszeichen: answer: "yes". Anführungszeichen zwingen den Parser, sie als Text zu behalten, statt sie in einen Boolean umzuwandeln.