Warum JSON oder YAML formatieren?
Wenn Sie mit REST-APIs oder CI/CD-Pipelines arbeiten, hantieren Sie täglich mehrfach mit JSON und YAML. Kompaktes JSON aus einer API-Antwort ist unlesbar; falsch eingerücktes YAML bringt ein Kubernetes-Deployment zum Scheitern. JSON zu minifizieren reduziert die Payload-Größe um 30-60 %, indem Leerzeichen und Zeilenumbrüche entfernt werden.
Drei häufige Anwendungsfälle:
- API-Debugging → Einen minifizierten JSON-Payload per Pretty-Print lesbar machen und Fehler identifizieren
- Konfigurationskonvertierung → JSON in YAML für eine
docker-compose.ymloder ein Kubernetes-Manifest umwandeln - Schnelle Validierung → Prüfen, ob ein JSON- oder YAML-Dokument Syntaxfehler enthält
So verwenden Sie den JSON / YAML Formatter in 3 Schritten
Schritt 1: Inhalt einfügen
Fügen Sie Ihr JSON oder YAML in das Eingabefeld ein. Das Tool akzeptiert Dokumente bis zu 1 MB.
Schritt 2: Vorgang wählen
Wählen Sie den passenden Modus:
- JSON formatieren: Pretty-Print mit Einrückung von 2 Leerzeichen (Standard) oder Minify
- JSON → YAML: Vollständige Konvertierung zu YAML
- YAML formatieren: Normalisiert die YAML-Einrückung
- YAML → JSON: Konvertierung zu eingerücktem JSON
Schritt 3: Ergebnis abrufen
Klicken Sie auf "Formatieren / Konvertieren". Das Ergebnis erscheint im Ergebnisfeld. Kopieren Sie es direkt.
Was sind JSON und YAML?
JSON (JavaScript Object Notation, RFC 8259) ist ein textbasiertes, strukturiertes Format (Objekte, Arrays, Skalare). Es ist der Standard für REST-APIs, Konfigurationsdateien und Datenaustausch.
YAML (YAML Ain't Markup Language, Spec 1.2) ist eine Obermenge von JSON und dank Einrückung besser lesbar. Es ist der Standard für Kubernetes-, Docker-Compose-, GitHub-Actions-, GitLab-CI- und Ansible-Konfigurationen. Jedes gültige JSON ist auch gültiges YAML.
Konvertierungsbeispiel:
{
"name": "captaindns.com",
"records": [
{"type": "A", "value": "93.184.216.34"},
{"type": "MX", "value": "mail.captaindns.com"}
]
}
Konvertiert zu YAML:
name: captaindns.com
records:
- type: A
value: 93.184.216.34
- type: MX
value: mail.captaindns.com
Welche Operationen unterstützt das Tool?
| Operation | Eingabe | Ausgabe | Typischer Einsatz |
|---|---|---|---|
| JSON formatieren | Kompaktes oder falsch eingerücktes JSON | Eingerücktes JSON (2 oder 4 Leerzeichen) oder minifiziert | API-Debugging, Lesbarkeit |
| JSON → YAML | Gültiges JSON | Formatiertes YAML | docker-compose, K8s-Manifest erstellen |
| YAML formatieren | YAML mit unregelmäßiger Einrückung | Normalisiertes YAML | Konfiguration vor dem Commit bereinigen |
| YAML → JSON | Gültiges YAML | Eingerücktes oder minifiziertes JSON | API-Payload aus YAML-Konfiguration vorbereiten |
Praxisnahe Anwendungsfälle
Szenario 1: API-Antwort debuggen
Symptom: Sie erhalten einen minifizierten JSON-Payload mit 500 Zeichen in einer einzigen Zeile. Diagnose: Fügen Sie das JSON ein und wählen Sie "JSON formatieren". Aktion: Das JSON wird eingerückt und lesbar. Identifizieren Sie das fehlerhafte Feld in Sekunden.
Szenario 2: Terraform-Konfiguration in YAML konvertieren
Symptom: Sie haben eine JSON-Ausgabe von terraform output -json und müssen sie in eine YAML-Datei integrieren.
Diagnose: Fügen Sie das JSON ein und wählen Sie "JSON → YAML".
Aktion: Kopieren Sie das generierte YAML direkt in Ihre Konfigurationsdatei.
Szenario 3: docker-compose.yml validieren
Symptom: Ein docker compose up schlägt mit einem Parsing-Fehler fehl.
Diagnose: Fügen Sie das YAML ein und wählen Sie "YAML formatieren". Wenn das YAML ungültig ist, zeigt das Tool den Fehler an.
Aktion: Korrigieren Sie den identifizierten Fehler und starten Sie das Deployment erneut.
❓ FAQ - Häufig gestellte Fragen
F: Welche maximale Größe wird akzeptiert?
A: Das Tool akzeptiert JSON- oder YAML-Dokumente bis zu 1 MB. Für größere Dateien verwenden Sie jq (JSON) oder yq (YAML) auf der Kommandozeile.
F: Validiert das Tool die JSON-Syntax?
A: Ja. Wenn das JSON ungültig ist, gibt das Tool eine explizite Fehlermeldung (ERR_INVALID_JSON_INPUT) mit einer beschreibenden Nachricht zurück.
F: Was ist der Unterschied zwischen JSON und YAML?
A: JSON verwendet geschweifte Klammern, Anführungszeichen und Kommas. YAML nutzt Einrückungen und ist für Menschen besser lesbar. YAML ist eine Obermenge von JSON.
F: Was bedeutet JSON minifizieren?
A: Minifizieren entfernt alle überflüssigen Leerzeichen und Zeilenumbrüche, um ein kompaktes JSON in einer einzigen Zeile zu erhalten.
F: Wie geht das Tool mit Nicht-String-Schlüsseln in YAML um?
A: YAML erlaubt numerische oder boolesche Schlüssel (true: value, 42: data). Bei der Konvertierung zu JSON werden sie automatisch in Zeichenketten umgewandelt.
F: Werden meine Daten gespeichert?
A: Nein. Der Inhalt wird im Arbeitsspeicher verarbeitet und sofort nach der Antwort gelöscht.
F: Kann ich dieses Tool zur Validierung einer Kubernetes-Datei verwenden?
A: Das Tool validiert die YAML-Syntax, nicht das Kubernetes-Schema. Verwenden Sie kubectl apply --dry-run für die Schema-Validierung.
Ergänzende Tools
| Tool | Zweck |
|---|---|
| Base64 Encoder / Decoder | JSON-Payloads in Base64 für den Transport kodieren |
| URL Encoder / Decoder | JSON in einem URL-Query-String kodieren |
| Regex Tester | Werte aus JSON mit regulären Ausdrücken extrahieren |
| Hash Generator | Hash eines JSON-Dokuments zur Integritätsprüfung berechnen |
Nützliche Ressourcen
- RFC 8259 - The JSON Data Interchange Format (offizielle JSON-Spezifikation)
- YAML 1.2 Specification (offizielle YAML-Spezifikation)
- jq - Command-line JSON processor (CLI-Tool zur JSON-Verarbeitung)
- yq - Command-line YAML processor (CLI-Tool zur YAML-Verarbeitung)