YAML formatieren und prüfen
YAML formatieren und prüfen in einem Schritt: einheitlich einrücken, Schlüssel sortieren, Anführungszeichen vereinheitlichen und Syntaxfehler mit Zeilennummer finden.
Alles läuft in Ihrem Browser. Eingaben verlassen Ihr Gerät nicht.
YAML prüfen und einheitlich einrücken
YAML formatieren bringt Konfigurationsdateien in eine einheitliche Form: gleiche Einrückung auf jeder Ebene, Listen sauber unter ihren Schlüsseln, überflüssige Leerzeichen entfernt. Gleichzeitig dient das Werkzeug als YAML Validator: Es liest die Datei mit einem eigenen Parser und meldet Fehler mit Zeilennummer und einer Erklärung auf Deutsch, etwa Tabulatoren in der Einrückung, doppelte Schlüssel, nicht geschlossene Anführungszeichen oder ein vergessenes Leerzeichen nach dem Doppelpunkt.
Typische Einsatzfälle sind docker-compose.yml, Kubernetes-Manifeste, GitHub-Actions-Workflows, Ansible-Playbooks und Spring-Boot-Konfigurationen. Sie können YAML einrücken mit 2 oder 4 Leerzeichen, Schlüssel sortieren und die Anführungszeichen vereinheitlichen. Kommentare, Anker (&name), Aliase (*name), Merge-Schlüssel (<<) und Tags wie !Ref bleiben erhalten. Bevor die Ausgabe erscheint, prüft das Werkzeug sie erneut, damit beim YAML prüfen und Umformatieren nichts verloren geht. Wer die Daten weiterverarbeiten möchte, wandelt sie mit YAML in JSON um.
Grenzen der YAML-Syntax-Unterstützung: Der Parser deckt gängiges YAML 1.2 ab, also Zuordnungen, Listen, verschachtelte Strukturen, Inline-Listen und -Objekte, Blocktexte mit | und > sowie mehrere Dokumente mit ---. Gefaltete Blocktexte (>) werden als wörtliche Blocktexte (|) mit gleichem Inhalt ausgegeben. Komplexe Schlüssel mit ? werden nicht unterstützt. Werte ohne Anführungszeichen wie yes, on oder 0123 bleiben unverändert, weil ältere YAML-1.1-Parser sie anders deuten als YAML 1.2.
Anleitung: YAML formatieren in 4 Schritten
- YAML in das Feld „YAML eingeben“ einfügen oder „Beispiel“ laden.
- Einrückung mit 2 oder 4 Leerzeichen wählen und festlegen, ob Listen unter Schlüsseln eingerückt werden.
- Anführungszeichen einstellen und bei Bedarf „Schlüssel alphabetisch sortieren“ oder „Kurze Listen in [ ] beibehalten“ aktivieren.
- Fehlermeldungen mit Zeilennummer beheben und das formatierte YAML mit „Kopieren“ übernehmen.
Typische Anwendungsfälle
- docker-compose.yml aufräumen: Eine gewachsene Compose-Datei einheitlich einrücken und Tabulatoren als Fehlerquelle finden.
- Workflows prüfen: Einen GitHub-Actions-Workflow vor dem Push auf Syntaxfehler kontrollieren.
- Kubernetes-Manifeste vereinheitlichen: Dateien aus verschiedenen Quellen auf gleiche Einrückung und Anführungszeichen bringen.
- Ansible-Fehler eingrenzen: Bei einer Fehlermeldung des Playbooks doppelte Schlüssel oder fehlende Leerzeichen nach dem Doppelpunkt aufspüren.
Häufige Fragen
Warum meldet YAML einen Tabulator-Fehler?
YAML erlaubt zum Einrücken ausschließlich Leerzeichen. Ein Tabulator am Zeilenanfang ist ein Syntaxfehler, auch wenn er im Editor gleich aussieht. Ersetzen Sie Tabs durch Leerzeichen, viele Editoren können das automatisch.
Bleiben Kommentare beim Formatieren erhalten?
Ja. Kommentarzeilen und Kommentare am Zeilenende bleiben an ihrem Schlüssel. Beim Sortieren wandern sie mit dem Schlüssel, zu dem sie gehören. Leerzeilen zwischen Blöcken werden auf eine reduziert.
Was bedeutet „Der Schlüssel kommt doppelt vor“?
In einer YAML-Zuordnung darf jeder Schlüssel nur einmal stehen. Manche Programme übernehmen stillschweigend den letzten Wert, der YAML-Standard verbietet doppelte Schlüssel aber. Der Validator zeigt die betroffene Zeile.
2 oder 4 Leerzeichen einrücken?
Beides ist gültig. Verbreitet sind 2 Leerzeichen, etwa bei Kubernetes, Docker Compose und GitHub Actions. Wichtig ist nur, dass eine Ebene durchgehend gleich eingerückt ist.
Ändert das Formatieren die Bedeutung?
Nein. Werte bleiben unverändert, auch Zahlen wie 1.10 oder Texte ohne Anführungszeichen. Die Ausgabe wird vor der Anzeige erneut eingelesen und geprüft.
Wie prüfe ich eine docker-compose.yml auf Fehler?
Syntaxfehler wie Tabulatoren oder fehlende Leerzeichen nach dem Doppelpunkt findet der YAML Validator hier. Ob die Datei auch inhaltlich zu Docker Compose passt, zeigt docker compose config, das die Datei einliest und die aufgelöste Konfiguration ausgibt.
Muss man Texte in YAML in Anführungszeichen setzen?
Meist nicht. Nötig sind sie, wenn ein Wert mit einem Sonderzeichen wie [, {, *, & oder ! beginnt, die Zeichenfolge „: “ oder „ #“ enthält oder sonst als Zahl, Datum oder Wahrheitswert gelesen würde, etwa "1.10", "yes" oder "0123".
Das könnte auch helfen
JSON minimieren
JSON auf eine Zeile verdichten: Leerraum entfernen, Zahlen exakt erhalten, optional Schlüssel sortieren.
ÖffnenJSON in CSV umwandeln
JSON-Arrays in CSV für Excel umwandeln: verschachtelte Felder als Spalten, Semikolon oder Komma.
ÖffnenCSV in JSON umwandeln
CSV in JSON umwandeln mit automatischer Trennzeichen-Erkennung und Anführungszeichen nach RFC 4180.
ÖffnenXML formatieren und prüfen
XML einrücken, minimieren und auf Wohlgeformtheit prüfen, mit Fehlerstelle in Zeile und Spalte.
ÖffnenXML in JSON umwandeln
XML in JSON umwandeln: Attribute mit Präfix, wiederholte Elemente als Arrays, Zahlen erkannt.
ÖffnenYAML in JSON umwandeln
YAML prüfen und in JSON umwandeln: Listen, Anker, Block-Strings und mehrere Dokumente.
Öffnen