Warum JSON oder YAML formatieren?
Wenn du mit REST-APIs oder CI/CD-Pipelines arbeitest, hantierst du 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 verwendest du den JSON / YAML Formatter in 3 Schritten
Schritt 1: Inhalt einfügen
Füge dein JSON oder YAML in das Eingabefeld ein. Das Tool akzeptiert Dokumente bis zu 1 MB.
Schritt 2: Vorgang wählen
Wähle 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
Klicke auf „Formatieren / Konvertieren". Das Ergebnis erscheint im Ergebnisfeld. Kopiere 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: Du erhältst einen minifizierten JSON-Payload mit 500 Zeichen in einer einzigen Zeile. Diagnose: Füge das JSON ein und wähle „JSON formatieren". Aktion: Das JSON wird eingerückt und lesbar. Identifiziere das fehlerhafte Feld in Sekunden.
Szenario 2: Terraform-Konfiguration in YAML konvertieren
Symptom: Du hast eine JSON-Ausgabe von terraform output -json und musst sie in eine YAML-Datei integrieren.
Diagnose: Füge das JSON ein und wähle „JSON → YAML".
Aktion: Kopiere das generierte YAML direkt in deine Konfigurationsdatei.
Szenario 3: docker-compose.yml validieren
Symptom: Ein docker compose up schlägt mit einem Parsing-Fehler fehl.
Diagnose: Füge das YAML ein und wähle „YAML formatieren". Wenn das YAML ungültig ist, zeigt das Tool den Fehler an.
Aktion: Korrigiere den identifizierten Fehler und starte 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 verwende 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. Verwende 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)