Wichtigste Erkenntnisse
- 01Formatiert YAML mit konsistenter Einrückung unter Verwendung des js-yaml-Parsers – derselbe Parser, der in Node.js-Build-Tools verwendet wird.
- 02Validiert die Syntax und gibt exakte Zeilennummern für Fehler aus.
- 03Konvertiert bidirektional zwischen YAML und JSON mit korrekter Typbeibehaltung.
- 04Nichts wird hochgeladen – die gesamte Verarbeitung läuft lokal in deinem Browser.
Warum YAML-Formatierung für Konfigurationsdateien wichtig ist
YAML ist die Standard-Konfigurationssprache für Kubernetes, GitHub Actions, Docker Compose, Helm-Charts und viele weitere Tools. Es ist auch berüchtigt für seine Empfindlichkeit gegenüber Einrückungen – eine einzige falsch eingerückte Zeile kann zu einem stillen Typ-Mismatch oder einem harten Parse-Fehler führen, der eine Bereitstellung blockiert. Regelmäßiges Formatieren hält Dateien konsistent und fängt Probleme ab, bevor sie die CI erreichen.
Die Konvertierung zwischen YAML und JSON ist gleichermaßen nützlich. Einige Tools akzeptieren nur JSON für API-Aufrufe oder Schema-Definitionen, während Menschen generell YAML für langfristige Konfigurationsdateien bevorzugen. Die Möglichkeit, zwischen den beiden Formaten hin und her zu wechseln, ohne Datentypen zu verlieren – Zahlen bleiben Zahlen, Booleans bleiben Booleans – spart Zeit und verhindert subtile Fehler.
So formatierst oder konvertierst du YAML
- 01
Füge dein YAML oder JSON ein
Füge ein Kubernetes-Manifest, einen GitHub Actions-Workflow, eine Helm-Values-Datei oder ein anderes YAML-Dokument ein. Für die JSON-zu-YAML-Konvertierung füge stattdessen JSON ein.
- 02
Wähle eine Aktion
Wähle YAML formatieren, um Einrückungen zu normalisieren und das Dokument an Ort und Stelle zu bereinigen. Wähle YAML zu JSON oder JSON zu YAML, um das Format vollständig zu konvertieren.
- 03
Überprüfe Fehler, falls vorhanden
Wenn die Eingabe einen Syntaxfehler enthält, zeigt das Tool die exakte Zeilennummer und den Grund vom js-yaml-Parser an – denselben Parser, den deine Node.js-Tools verwenden, sodass der Fehler dem entspricht, den du in der Produktion sehen würdest.
- 04
Kopiere die Ausgabe
Klicke auf Kopieren, um die formatierte oder konvertierte Ausgabe zu übernehmen. Füge sie zurück in deine Konfigurationsdatei, einen API-Body oder eine Schema-Definition ein.
Wann dieses Tool dir Zeit spart
- 01Kubernetes-Manifest ist abgewichen – normalisiere Einrückungen vor dem Commit.
- 02GitHub Actions-Workflow kann nicht geparst werden – validiere, um die exakte Fehlerzeile zu erhalten.
- 03API akzeptiert nur JSON, aber die Konfiguration ist als YAML gespeichert – konvertiere mit einem Klick.
- 04Onboarding eines neuen Service – konvertiere die JSON-Beispiel-Payload zu YAML für das Helm-Chart.
- 05YAML von Stack Overflow kopieren – formatiere neu, um deinen Projekt-Style mit 2-Leerzeichen zu entsprechen.
- 06Debugging eines Helm-Values-Merge – validiere, dass jede values.yaml einzeln sauber ist.
Privat, kein Upload erforderlich
Formatierung und Konvertierung laufen vollständig in deinem Browser mit js-yaml – derselbe Parser, der in Webpack, Rollup und den meisten JavaScript-Build-Tools gebündelt ist. Deine Konfigurationsdateien, Secrets-Referenzen und Umgebungsvariablennamen verlassen dein Gerät nie.
Der Parser zielt auf YAML 1.2 ab, das ist die Version, die Kubernetes, GitHub Actions, Docker Compose und Helm alle verwenden. Wenn eine Datei hier validiert, wird sie in diesen Tools korrekt geladen.
YAML-Formatter – Häufig gestellte Fragen
Werden Kommentare bei der YAML-Formatierung beibehalten?
Nein. Der js-yaml-Parser verwirft Kommentare beim Parsen – dies ist eine Einschränkung aller JavaScript-YAML-Parser. Formatiere zuerst, dann füge Kommentare manuell hinzu.
Welche YAML-Version wird unterstützt?
YAML 1.2, das ist die Version, die von Kubernetes, GitHub Actions, Docker Compose und Helm verwendet wird. Was hier validiert, wird in diesen Tools sauber geladen.
Bleiben die Typen bei der Konvertierung von YAML zu JSON erhalten?
Ja. Zahlen, Booleans, null und Datums-Strings werden korrekt konvertiert. Ein true in YAML wird zu einem Boolean true in JSON, nicht zum String 'true'.
Was ist der Unterschied zwischen Formatierung und Konvertierung?
Formatierung behält die Datei als YAML und normalisiert Leerzeichen und Einrückungen. Konvertierung ändert das Ausgabeformat vollständig – YAML zu JSON erzeugt ein .json-kompatibles Dokument.
Mein YAML hat mehrere Dokumente, getrennt durch ---. Werden alle verarbeitet?
Das erste Dokument wird geparst und neu ausgegeben. Bei Multi-Document-Dateien teile jeden Abschnitt bei --- auf und verarbeite sie einzeln.