YAML Validator & Formatter
Füge YAML ein und prüfe es sofort: Fehler werden mit Zeile und Spalte angezeigt, und die fehlerhafte Zeile wird hervorgehoben. Danach kannst du es formatieren, minimieren, Schlüssel sortieren oder in JSON umwandeln. Alles läuft in deinem Browser.
Zuletzt aktualisiert:
Beim Formatieren werden die Daten neu geschrieben, daher bleiben Kommentare im Ergebnis nicht erhalten. Die Prüfung verändert deine Eingabe nie.
Anleitung: YAML Validator & Formatter
- Füge YAML in den Editor ein oder klicke auf „Hochladen“, um eine .yaml-, .yml- oder .json-Datei zu öffnen.
- Lies die Statusleiste: Sie meldet „Gültiges YAML“ oder zeigt Zeile und Spalte des ersten Fehlers, wobei die Zeile rot hervorgehoben wird.
- Klicke auf „YAML formatieren“, um mit deiner Einrückung und optional sortierten Schlüsseln zu formatieren, oder auf „Minimieren“ für den kompakten Flow-Stil.
- Umwandeln mit YAML → JSON, oder füge JSON ein und klicke auf JSON → YAML.
- Kopiere das Ergebnis oder lade es herunter aus dem rechten Feld.
Die häufigsten YAML-Fehler und wie du sie behebst
| Fehlermeldung | Typische Ursache | Lösung |
|---|---|---|
| bad indentation of a mapping entry (falsche Einrückung eines Mapping-Eintrags) | Ein Schlüssel ist mit einer anderen Anzahl Leerzeichen eingerückt als seine Geschwister | Richte Schlüssel derselben Ebene exakt auf dieselbe Spalte aus |
| end of the stream or a document separator is expected (Ende des Datenstroms oder Dokumenttrenner erwartet) | Text nach einem Wert auf derselben Ebene, oft ein fehlender Doppelpunkt oder ein zusätzliches Leerzeichen vor einem Schlüssel | Prüfe die Zeile über der gemeldeten auf ein fehlendes : |
| duplicated mapping key (doppelter Schlüssel im Mapping) | Derselbe Schlüssel kommt in einem Mapping zweimal vor; die meisten Parser behalten stillschweigend nur den letzten | Entferne oder benenne einen der Schlüssel um |
| tab characters must not be used in indentation (Tabulatoren dürfen nicht zur Einrückung verwendet werden) | Die Datei wurde mit Tabulatoren eingerückt | Ersetze Tabulatoren durch Leerzeichen (üblich sind 2 pro Ebene) |
| unexpected end of the stream within a double quoted scalar (unerwartetes Ende innerhalb einer Zeichenkette in doppelten Anführungszeichen) | Ein öffnendes Anführungszeichen ohne schließendes | Schließe das Anführungszeichen oder maskiere innere Anführungszeichen |
| incomplete explicit mapping pair; a key node is missed (unvollständiges explizites Mapping-Paar; ein Schlüssel fehlt) | Ein Wert, der ohne Anführungszeichen mit ?, :, {, [, &, *, !, |, >, @ oder % beginnt | Setze den Wert in Anführungszeichen, zum Beispiel pattern: "*.log" |
YAML-Syntax-Spickzettel
| Element | YAML | JSON-Entsprechung |
|---|---|---|
| Mapping | name: app | {"name": "app"} |
| Sequenz | - a- b | ["a", "b"] |
| Flow-Stil | {a: 1, b: [x, y]} | {"a": 1, "b": ["x", "y"]} |
| Literal-Block (behält Zeilenumbrüche) | script: | line 1 line 2 | "line 1\nline 2\n" |
| Gefalteter Block (verbindet Zeilen) | text: > one two | "one two\n" |
| Anker und Alias | base: &b {x: 1}copy: *b | Der Alias-Wert wird wiederholt |
| Null | ~, null oder ein leerer Wert | null |
| Kommentar | # note | In JSON nicht unterstützt |
| Mehrere Dokumente | --- zwischen Dokumenten | Ein Array von Dokumenten |
Tipps für Konfigurationsdateien
- Setze mehrdeutige Werte in Anführungszeichen. Versionsnummern wie
1.10werden zur Zahl 1.1, und Uhrzeiten wie22:30können von YAML-1.1-Parsern als Zahlen gelesen werden. Schreibe"1.10"und"22:30". - Halte die Einrückung einheitlich. Wähle 2 Leerzeichen pro Ebene und stelle deinen Editor so ein, dass er beim Drücken der Tabulatortaste Leerzeichen einfügt.
- Achte auf Listeneinträge unter einem Schlüssel. In Kubernetes, Docker Compose und GitHub Actions sind sowohl
key:gefolgt von- itemin derselben Spalte als auch um zwei Leerzeichen eingerückt gültig, aber beide Stile in einer Datei zu mischen, führt leicht zu Fehlern. - Prüfe vor dem Deployment. Eine Syntaxprüfung hier findet strukturelle Fehler; Tools wie
kubectl apply --dry-run=clientoderdocker compose configprüfen danach den Inhalt gegen ihr eigenes Schema.
Häufige Fragen
Was prüft der Validator?
Er liest den Text mit js-yaml, einem YAML-1.2-Parser, und meldet Syntaxfehler wie falsche Einrückung, Tabulatoren zur Einrückung, nicht geschlossene Anführungszeichen oder Klammern, doppelte Schlüssel in einem Mapping sowie ungültige Anker oder Aliase. Er prüft, ob das YAML wohlgeformt ist; gegen ein Schema wie eine Kubernetes- oder GitHub-Actions-Spezifikation prüft er es nicht.
Warum sind meine Kommentare nach dem Formatieren weg?
Beim Formatieren wird das YAML in Daten eingelesen und neu geschrieben, und Kommentare gehören nicht zu den Daten. Nutze die formatierte Ausgabe, wenn du eine saubere, normalisierte Datei willst, und behalte das Original, wenn die Kommentare wichtig sind. Die Prüfung verändert deinen Text nie.
Darf ich in YAML Tabulatoren verwenden?
Nein. Die YAML-Spezifikation verbietet Tabulatorzeichen zur Einrückung; verwende Leerzeichen. Tabulatoren in Zeichenketten mit Anführungszeichen oder nach einem Wert sind in Ordnung. Der Validator zeigt genau die Zeile an, in der ein Tabulator zur Einrückung verwendet wird.
Wie prüfe ich eine Datei mit mehreren Dokumenten?
Trenne die Dokumente mit einer Zeile aus drei Bindestrichen (---), wie in Kubernetes-Manifesten. Der Validator liest jedes Dokument, die Statusleiste zeigt, wie viele er gefunden hat, und YAML → JSON gibt sie als JSON-Array zurück.
Was ist der Unterschied zwischen YAML und JSON?
JSON ist in der Praxis eine strikte Teilmenge von YAML 1.2, daher sind die meisten JSON-Dateien auch gültiges YAML. YAML ergänzt Kommentare, eine Struktur über Einrückung, Anker und Aliase zur Wiederverwendung, mehrzeilige Zeichenketten und mehrere Dokumente pro Datei, weshalb es für Konfigurationen beliebt ist.
Warum wurde aus 'no' oder 'on' true oder false?
Ältere YAML-1.1-Parser behandelten yes, no, on und off als Wahrheitswerte (das „Norwegen-Problem“, bei dem der Ländercode NO zu false wird). js-yaml folgt YAML 1.2, wo nur true und false Wahrheitswerte sind, andere Tools können sich aber anders verhalten. Setze solche Werte sicherheitshalber in Anführungszeichen.
Wird mein YAML hochgeladen?
Nein. Das Einlesen passiert in deinem Browser. Die js-yaml-Bibliothek wird einmal von einem öffentlichen CDN geladen, und deine Daten bleiben auf deinem Gerät.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.