YAML Formatter: YAML validieren und formatieren

Was ist der YAML Formatter?

YAML Formatter ist ein browserbasiertes Tool, das YAML-Text parst, validiert und mit konsistenter, konfigurierbarer Einrückung neu serialisiert. YAMLs einrückungssensitive Syntax bedeutet, dass ein einziger falsch ausgerichteter Block die Bedeutung eines gesamten Dokuments ändern oder einen Fehler erzeugen kann, der schwer zu lokalisieren ist. Dieses Tool erkennt solche Probleme sofort und produziert saubere Ausgaben, die Ihrem bevorzugten Stil entsprechen.

Über die grundlegende Formatierung hinaus konvertiert das Tool YAML direkt zu JSON — nützlich, wenn eine API oder ein Tool JSON erfordert, Ihre Quellkonfiguration aber YAML ist, oder wenn Sie überprüfen möchten, ob Ihr YAML zur erwarteten Datenstruktur parst. Beide Operationen laufen vollständig in Ihrem Browser mit der js-yaml-Bibliothek. Keine Daten verlassen Ihren Rechner, es ist kein Konto erforderlich, und das Tool ist kostenlos.

Hauptfunktionen

• YAML mit korrekter Einrückung formatieren — Parst die Eingabe mit js-yaml und gibt sie mit Ihrer gewählten Einrückungsgröße neu aus. Die Option lineWidth: -1 verhindert, dass der Formatter Zeilenumbrüche in langen Strings einführt, und noRefs: true expandiert Anker und Aliasse in ihre vollen Werte.
• YAML-Syntax mit Fehlermeldungen validieren — Wenn js-yaml einen Parse-Fehler wirft, erscheint die genaue Fehlermeldung (einschließlich Zeilennummer) unterhalb des Ausgabebereichs. Fehler verwenden ein zugängliches role="alert"-Attribut.
• YAML zu JSON konvertieren — Parst das YAML und serialisiert das Ergebnis als JSON mit JSON.stringify und Ihrer gewählten Einrückung. Die Download-Logik erkennt, ob die Ausgabe mit { oder [ beginnt, und speichert die Datei automatisch mit einer .json-Erweiterung.
• Formatierte Ausgabe in die Zwischenablage kopieren — Verwendet die Clipboard API mit einem Textarea-Fallback.
• Als .yaml oder .json Datei herunterladen — Wenn die Ausgabe JSON ist (aus der Konvertierungsoperation), wird die Datei als formatted.json gespeichert. Wenn die Ausgabe YAML ist (aus der Formatierungsoperation), wird sie als formatted.yaml gespeichert.
• Tastaturkürzel — Strg+Enter (Cmd+Enter) formatiert; Strg+Shift+J (Cmd+Shift+J) konvertiert zu JSON.

So verwenden Sie den YAML Formatter

Schritt 1: Ihr YAML einfügen

Navigieren Sie zum Tool unter /developer/code/yaml-formatter. Fügen Sie Ihr YAML in das Eingabefeld auf der linken Seite ein. Das Textarea-Element ist monospace und in der Größe veränderbar. YAML-Dokumente jeder Größe, die in den Browserspeicher passen, werden akzeptiert — das Tool erzwingt keine Größenbeschränkung.

Schritt 2: Einrückung wählen

Öffnen Sie das Einrückungs-Dropdown in der Aktionsleiste unterhalb der Felder. Wählen Sie 2 Leerzeichen oder 4 Leerzeichen. Die Auswahl wirkt sich sowohl auf die Formatierungsausgabe als auch auf die JSON-Konvertierungsausgabe aus. Zwei-Leerzeichen-Einrückung ist der YAML-Community-Standard und wird von Kubernetes-Manifesten, Ansible-Playbooks und den meisten CI/CD-Pipeline-Dateien verwendet. Vier-Leerzeichen-Einrückung entspricht einigen Python- und Java-Projektkonventionen.

Schritt 3: Formatieren oder konvertieren

Klicken Sie auf Format (oder drücken Sie Strg+Enter / Cmd+Enter), um eine normalisierte YAML-Ausgabe im rechten Bereich zu erzeugen. Klicken Sie auf To JSON (oder drücken Sie Strg+Shift+J / Cmd+Shift+J), um ein äquivalentes JSON-Dokument zu erzeugen.

Beispieleingabe — ein Kubernetes Deployment-Manifest mit inkonsistenter Einrückung:

apiVersion: apps/v1
kind: Deployment
metadata:
    name: web-frontend
    labels:
      app: web
spec:
  replicas: 3
  selector:
      matchLabels:
        app: web
  template:
      metadata:
        labels:
          app: web
      spec:
        containers:
        - name: nginx
          image: nginx:1.25
          ports:
          - containerPort: 80

Ausgabe nach der Formatierung mit 2-Leerzeichen-Einrückung:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-frontend
  labels:
    app: web
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: nginx
          image: nginx:1.25
          ports:
            - containerPort: 80

Schritt 4: Zu JSON konvertieren (optional)

Mit demselben YAML in der Eingabe klicken Sie auf To JSON. Das Ausgabefeld zeigt das äquivalente JSON-Dokument:

{
  "apiVersion": "apps/v1",
  "kind": "Deployment",
  "metadata": {
    "name": "web-frontend",
    "labels": {
      "app": "web"
    }
  }
}

(Abgekürzt der Kürze halber — das vollständige Dokument würde spec enthalten)

Schritt 5: Kopieren oder herunterladen

Klicken Sie auf Copy, um die Ausgabe in Ihre Zwischenablage zu kopieren. Klicken Sie auf Download, um die Datei zu speichern. Das Tool wählt automatisch .yaml oder .json als Dateiendung, basierend darauf, ob die Ausgabe wie JSON aussieht (beginnt mit { oder [).

Praktische Beispiele

Normalisierung einer CI/CD-Pipeline-Datei

Eine GitHub Actions-Workflow-Datei wurde von mehreren Mitwirkenden bearbeitet und weist gemischte Einrückungen auf. Fügen Sie sie in den Formatter ein, klicken Sie auf Format mit 2-Leerzeichen-Einrückung, und die Ausgabe zeigt eine konsistente Einrückung. Vergleichen Sie vor dem Committen Eingabe und Ausgabe, um zu bestätigen, dass keine semantischen Unterschiede eingeführt wurden — da YAML einrückungssensitiv ist, kann die Neuformatierung Ausrichtungsfehler aufdecken, die im Original versteckt waren.

Überprüfung der Konfigurationsstruktur

Sie pflegen eine Konfigurationsdatei für eine Node.js-Anwendung, die mit YAML bereitgestellt wird, aber die Runtime liest sie als geparste JavaScript-Objekte. Fügen Sie die Konfiguration ein und klicken Sie auf To JSON. Die JSON-Ausgabe zeigt genau, wie das geparste Objekt aussieht, einschließlich aller Typkonvertierungen (bloße true/false → Booleans, nicht gequotete Zahlen → Zahlen). Dies bestätigt, dass Werte wie port: 8080 eine Zahl und nicht der String "8080" sein werden.

Eingabe:

server:
  host: 0.0.0.0
  port: 8080
  debug: false
database:
  url: postgres://localhost:5432/myapp
  pool: 10

JSON-Ausgabe:

{
  "server": {
    "host": "0.0.0.0",
    "port": 8080,
    "debug": false
  },
  "database": {
    "url": "postgres://localhost:5432/myapp",
    "pool": 10
  }
}

Expandierung von YAML-Ankern

YAML unterstützt Anker (&) und Aliasse (*) zur Wiederverwendung von Werten. Der Formatter verwendet noRefs: true, was bedeutet, dass alle Aliasse in der Ausgabe in ihre vollen Werte expandiert werden. Dadurch wird das formatierte Dokument eigenständig und leichter lesbar in Tools, die keine Anker unterstützen.

Tipps und Best Practices

Der Formatter bewahrt die Schlüsselreihenfolge. Die js-yaml-Dump-Optionen umfassen sortKeys: false, sodass Ihre Schlüsselreihenfolge in der formatierten Ausgabe beibehalten wird. Dies ist wichtig für Kubernetes- und Ansible-Dokumente, bei denen die Feldreihenfolge konventionsgemäß wichtig ist, auch wenn sie technisch nicht erforderlich ist.

Lange Strings werden nicht umgebrochen. Die Einstellung lineWidth: -1 deaktiviert den automatischen Zeilenumbruch. Mehrzeilige Strings und lange Werte bleiben auf einer einzigen Zeile statt an einer willkürlichen Spalte zu umbrechen. Wenn Sie umgebrochene Ausgabe benötigen, kopieren Sie das Ergebnis und wenden Sie den Umbruch in Ihrem Editor an.

Vor dem Commit validieren. YAML-Einrückungsfehler sind eine häufige Ursache für CI-Fehler. Führen Sie Ihre Pipeline-Datei durch diesen Formatter, bevor Sie pushen. Ein sauberer Formatierungsdurchlauf ohne Fehlermeldung bestätigt, dass das YAML syntaktisch gültig ist.

Überprüfen Sie die Dateiendung beim Download. Die Download-Logik untersucht den Ausgabeinhalt, nicht die durchgeführte Operation. Wenn Sie YAML formatiert haben und das YAML zufällig mit { beginnt (manche YAML-Dateien verwenden JSON-kompatible Syntax), wird die Datei als .json gespeichert. Benennen Sie sie bei Bedarf um.

YAML-Booleans sind streng. Die YAML-Spezifikation erkennt true, false, yes, no, on und off als Boolean-Werte in YAML 1.1. Die js-yaml-Bibliothek folgt standardmäßig YAML 1.2, wo nur true und false Booleans sind. Wenn Ihr YAML yes/no verwendet, behandelt der Formatter sie als einfache Strings.

Häufige Probleme und Fehlerbehebung

Fehlermeldung mit Zeilen- und Spaltennummer — js-yaml-Parse-Fehler enthalten den genauen Ort des Problems. Schauen Sie in Ihrer Eingabe die angegebene Zeile an. Häufige Ursachen sind: Tabs zur Einrückung statt Leerzeichen (YAML erlaubt keine Tabs), ein Doppelpunkt in einem nicht gequoteten String (z.B. muss url: http://example.com als url: "http://example.com" geschrieben werden oder einen Blockskalar verwenden), oder eine falsche Verschachtelungsebene.

Ausgabe enthält nicht alle Werte aus der Eingabe — Wenn Ihr YAML !!-Typ-Tags (z.B. !!binary, !!timestamp) verwendet, die js-yaml nicht erkennt, können diese Werte gelöscht oder transformiert werden. Untersuchen Sie die spezifischen Werte, um das Typ-Tag zu identifizieren, und quoten Sie den Wert bei Bedarf.

Fehler "Please enter YAML to format" — Das Eingabefeld ist leer oder enthält nur Leerzeichen, als Sie auf Format oder Konvertieren geklickt haben. Fügen Sie zuerst Ihr YAML in das Eingabefeld ein.

Konvertiertes JSON hat unerwartete Null-Werte — Ein YAML-Wert von ~ oder ein leerer Wert (Schlüssel ohne Wert nach dem Doppelpunkt) wird in JSON zu null. Dies ist korrektes Verhalten und entspricht der YAML-Spezifikation. Quoten Sie den Wert, wenn Sie den String "~" oder einen leeren String "" beabsichtigt haben.

Download speichert als .json statt .yaml — Der Download-Handler prüft, ob die Ausgabe mit { oder [ beginnt. Manche YAML-Dokumente sind in JSON-kompatibler YAML-Syntax geschrieben und beginnen mit einer geschweiften Klammer. Benennen Sie in diesem Fall die heruntergeladene Datei nach dem Speichern in .yaml um.

Datenschutz und Sicherheit

YAML Formatter verarbeitet alle Eingaben lokal in Ihrem Browser mit der js-yaml-Bibliothek. Kein Text, den Sie einfügen — einschließlich Datenbankverbindungsstrings, API-Token, privater Schlüssel oder persönlicher Konfigurationsdaten — wird an einen Server gesendet. Das Tool funktioniert ohne Netzwerkverbindung, sobald die Seite geladen ist. Es gibt kein Session-Tracking bei Formatierungsoperationen.

Häufig gestellte Fragen

Ist der YAML Formatter kostenlos? Ja, vollständig kostenlos ohne Nutzungslimits. Alle Formatierungs-, Validierungs- und Konvertierungsoperationen sind kostenlos verfügbar. Glyph Widgets Supporter-Funktionen — gespeicherte Voreinstellungen, Sitzungsverlauf, Tool-Notizen — sind für Ko-fi-Unterstützer verfügbar, aber die YAML-Kernfunktionalität erfordert nichts davon.

Funktioniert es offline? Ja. Die gesamte Verarbeitung läuft in Ihrem Browser. Sobald die Seite geladen ist, können Sie die Internetverbindung trennen und den Formatter und Konverter weiter ohne Unterbrechung nutzen.

Sind meine Daten sicher? Ja. Ihre YAML-Eingabe wird niemals an einen Server übertragen. Sie befindet sich nur im Arbeitsspeicher Ihres Browsers und wird gelöscht, wenn Sie auf Löschen klicken oder den Tab schließen.

Unterstützt der Formatter YAML-Multi-Dokument-Dateien (mehrere ----Abschnitte)? Die js-yaml-Funktion load parst das erste Dokument in einem Stream. Multi-Dokument-YAML-Dateien (getrennt durch ---) haben nur ihr erstes Dokument formatiert. Verwenden Sie yaml.loadAll-Verhalten für Multi-Dokument-Dateien — aber dieses Tool verarbeitet derzeit nur das erste Dokument.

Was ist der Unterschied zwischen Format und To JSON? Format serialisiert das geparste YAML mit konsistenter Einrückung wieder als YAML. To JSON serialisiert dieselben geparsten Daten als JSON-Dokument. Beide Operationen verwenden denselben Parse-Schritt, validieren also beide das YAML und schlagen bei ungültiger Eingabe identisch fehl.

Bewahrt das Tool Kommentare? Nein. Der js-yaml-Parser verwirft Kommentare beim Parsen. Nach der Formatierung erscheinen Kommentare aus der ursprünglichen Eingabe nicht in der Ausgabe. Wenn Sie Kommentare beibehalten möchten, bearbeiten Sie die Einrückung manuell in Ihrer Quelldatei.

Kann ich JSON in YAML konvertieren? Dieses Tool konvertiert YAML in JSON. Für die umgekehrte Konvertierung verwenden Sie das Tool Demnächst verfügbar: JSON Converter, das JSON-zu-YAML-Konvertierung unterstützt.

Welche YAML-Version unterstützt das Tool? Die js-yaml-Bibliothek implementiert YAML 1.2, das bei Boolean-Werten und einigen anderen Randfällen strenger ist als YAML 1.1. Die meisten modernen YAML-Dateien (Kubernetes, Docker Compose, GitHub Actions usw.) sind so geschrieben, dass sie mit YAML 1.2 kompatibel sind.

Was ist der Tastaturkürzel für die JSON-Konvertierung? Drücken Sie Strg+Shift+J unter Windows/Linux oder Cmd+Shift+J unter macOS, um die Konvertierung zu JSON auszulösen. Drücken Sie Strg+Enter oder Cmd+Enter zum Formatieren.

Spiegelt die Dateiendung beim Download die durchgeführte Operation wider? Nicht direkt — der Download-Handler prüft, ob der Ausgabetext mit { oder [ beginnt, um zwischen .json und .yaml zu entscheiden. Formatierte YAML-Ausgabe, die mit einem Mapping beginnt, wird als .yaml gespeichert, und JSON-konvertierte Ausgabe (die immer mit { oder [ beginnt) wird als .json gespeichert.

Verwandte Tools

JSON Formatter — JSON mit Schema-Validierung, Schema-Generierung und interaktivem Baumansicht-Viewer formatieren, validieren und minifizieren.

XML Formatter — XML-Dokumente mit denselben Einrückungskontrollen und Minifizierungsunterstützung formatieren und validieren.

Demnächst verfügbar: TOML Formatter — TOML-Konfigurationsdateien formatieren und validieren.

Jetzt YAML Formatter ausprobieren: YAML Formatter