YAML-Validator & Formatierer

YAML einfügen, die Syntax prüfen, Fehler genau lokalisieren und eine sauber, einheitlich formatierte Ausgabe erhalten.

Ausgabeoptionen

YAMLEingabe

Leer

YAMLAusgabe

Die YAML-Ausgabe erscheint hier

Läuft vollständig in Ihrem Browser: nichts wird hochgeladen. Es gelten Fair-Use-Limits (5 MB pro Eingabe, begrenzte Anzahl an Konvertierungen), um Spam und Bots zu verhindern.

Von URL laden

Die Datei wird direkt von Ihrem Browser abgerufen, daher muss der Server Cross-Origin-Anfragen zulassen.

Tastenkürzel

Ctrl / ⌘ + Enter Jetzt konvertieren
Ctrl / ⌘ + S Ausgabe herunterladen
Alt + Shift + C Ausgabe kopieren
Alt + Shift + F JSON-Eingabe reparieren und formatieren
Alt + Shift + S Richtung umkehren
Alt + Shift + T Zwischen Code-, Baum- und Zuordnungsansicht wechseln
Ctrl / ⌘ + Z Rückgängig, auch nach Formatieren, Reparieren und Leeren
Esc Vollbild verlassen
Textgröße im Editor

Unordentliches YAML vereinheitlichen

Gemischte Einrückung, Inline-Maps und unnötige Anführungszeichen lassen sich problemlos parsen, sind aber schwer zu prüfen. Die formatierte Ausgabe gibt jeder Datei dieselbe Form.

Eingabe
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
Formatiert
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

Häufige YAML-Fehler und wie Sie sie beheben

Diese Meldungen sehen Sie am häufigsten, in diesem Validator und in Tools wie kubectl, Helm und docker compose.

FehlermeldungBedeutung und Lösung
tab characters must not be used in indentation YAML erlaubt zur Einrückung nur Leerzeichen. Ersetzen Sie jeden Tab durch Leerzeichen.
bad indentation of a mapping entry Ein Schlüssel ist anders eingerückt als seine Geschwister, oder ein einfacher Wert enthält ": ". Richten Sie den Schlüssel an seinen Nachbarn aus oder setzen Sie den Wert in Anführungszeichen.
mapping values are not allowed in this context Dasselbe Problem, wie kubectl und Helm es melden: meist ein Wert ohne Anführungszeichen, der ": " enthält, etwa eine URL oder eine Uhrzeit. Setzen Sie den Wert in Anführungszeichen.
end of the stream or a document separator is expected Ein Listenelement oder Schlüssel steht auf der falschen Einrückungsebene, zum Beispiel eine Liste, auf die ein Mapping auf derselben Ebene folgt.
unexpected end of the stream within a flow collection Eine Inline-Liste [ … ] oder Map { … } wird nie geschlossen. Ergänzen Sie die fehlende Klammer.
duplicated mapping key Derselbe Schlüssel kommt in einem Mapping zweimal vor. Entfernen oder benennen Sie einen davon um.
unidentified alias Ein Alias wie *defaults wird vor seinem Anker &defaults oder ganz ohne ihn verwendet.

Was der Validator prüft

Machen Sie die Datei mit den Schaltflächen absichtlich kaputt und beobachten Sie, welche Prüfung es bemerkt.

Syntax und Einrückung

Tabs, falsch ausgerichtete Schlüssel, nicht geschlossene Anführungszeichen und Klammern werden mit exakter Zeile und Spalte gemeldet.

Doppelte Schlüssel

Ein zweimal im selben Mapping definierter Schlüssel ist ein Fehler, während manche Parser stillschweigend den letzten Wert behalten.

Anker und Aliase

Jeder Alias muss auf einen zuvor im Dokument definierten Anker zeigen, und Merge-Keys müssen auf Mappings verweisen.

Mehrere Dokumente

Jedes Dokument einer durch --- getrennten Datei wird geparst, und die Hinweise zeigen, wie viele gefunden wurden.

Standardmäßig privat

Die Validierung läuft in Ihrem Browser, daher verlassen Geheimnisse in CI-Dateien und Manifesten nie Ihren Rechner.

Weitere Tools

Konverter, Validatoren und Schritt-für-Schritt-Anleitungen für alle Stellen, an denen JSON und YAML aufeinandertreffen.

Häufig gestellte Fragen

Wie validiere ich YAML online?

Fügen Sie Ihr YAML ein oder legen Sie eine .yaml- oder .yml-Datei ab. Das Badge zeigt beim Tippen „Gültiges YAML“ oder „Ungültiges YAML“. Bei einer ungültigen Datei erhalten Sie die Fehlermeldung mit exakter Zeile und Spalte, und die Zeile wird im Editor hervorgehoben.

Was macht die formatierte Ausgabe?

Sie schreibt dieselben Daten mit einheitlicher Einrückung und Anführungszeichen neu: Blockstil, Ihre gewählte Einrückung und Anführungszeichen nur, wo nötig. So vereinheitlichen Sie eine Datei schnell vor dem Commit.

Bleiben Kommentare in der formatierten Ausgabe erhalten?

Nein. Der Validator parst das YAML in Daten und schreibt diese neu, und Kommentare gehören nicht zu den Daten. Nutzen Sie die Ausgabe, um die Struktur zu prüfen, und behalten Sie Ihre Originaldatei, wenn deren Kommentare wichtig sind.

Kann ich eine Multi-Dokument-YAML-Datei validieren?

Ja. Durch --- getrennte Dokumente werden einzeln geprüft, und die formatierte Ausgabe behält sie als separate Dokumente bei. Die Hinweise unter dem Editor zeigen, wie viele Dokumente gefunden wurden.

Prüft es Kubernetes- oder Docker Compose-Schemas?

Es prüft die YAML-Syntax, kein bestimmtes Schema. Eine Datei kann gültiges YAML sein und trotzdem von kubectl oder docker compose wegen eines unbekannten Felds abgelehnt werden. Verwenden Sie für Schemaprüfungen kubectl apply --dry-run=server oder docker compose config.

Welche YAML-Version wird verwendet?

Das Parsen folgt dem Core-Schema von YAML 1.2, daher bleiben yes, no, on und off Zeichenketten. Mit aktiviertem „YAML 1.1-sicher“ setzt die Ausgabe diese Wörter in Anführungszeichen, sodass auch ältere Parser wie PyYAML sie als Zeichenketten lesen.