Pourquoi formater du JSON ou du YAML ?
Si vous travaillez avec des API REST ou des pipelines CI/CD, vous manipulez du JSON et du YAML plusieurs fois par jour. Un JSON compact copié depuis une réponse API est illisible ; un YAML mal indenté casse un déploiement Kubernetes. Minifier du JSON réduit la taille d'un payload de 30 à 60 % en supprimant espaces et retours à la ligne.
Trois cas d'usage courants :
- Debug API → Pretty-print un payload JSON minifié pour lire les champs et identifier une erreur
- Conversion de config → Transformer un JSON en YAML pour un
docker-compose.ymlou un manifest Kubernetes - Validation rapide → Vérifier qu'un document JSON ou YAML ne contient pas d'erreur de syntaxe
Comment utiliser le JSON / YAML Formatter en 3 étapes
Étape 1 : Coller le contenu
Collez votre JSON ou YAML dans la zone de saisie. L'outil accepte des documents jusqu'à 1 Mo.
Étape 2 : Choisir l'opération
Sélectionnez le mode adapté :
- Formater JSON : pretty-print avec indentation 2 espaces (défaut), ou minify
- JSON → YAML : conversion complète vers YAML
- Formater YAML : normalise l'indentation YAML
- YAML → JSON : conversion vers JSON indenté
Étape 3 : Récupérer le résultat
Cliquez sur « Formater / Convertir ». Le résultat apparaît dans la zone de résultat. Copiez-le directement.
Qu'est-ce que JSON et YAML ?
JSON (RFC 8259) est un format textuel structuré (objets, tableaux, scalaires). C'est le standard dominant des API REST et des échanges de données sur le web.
YAML (spec 1.2) est un surensemble de JSON, plus lisible grâce à l'indentation. C'est le standard pour les configs Kubernetes, Docker Compose, GitHub Actions, GitLab CI et Ansible. Tout JSON valide est aussi du YAML valide.
Exemple de conversion :
{
"name": "captaindns.com",
"records": [
{"type": "A", "value": "93.184.216.34"},
{"type": "MX", "value": "mail.captaindns.com"}
]
}
Converti en YAML :
name: captaindns.com
records:
- type: A
value: 93.184.216.34
- type: MX
value: mail.captaindns.com
Quelles opérations l'outil supporte-t-il ?
| Opération | Entrée | Sortie | Usage typique |
|---|---|---|---|
| Formater JSON | JSON compact ou mal indenté | JSON indenté (2 ou 4 espaces) ou minifié | Debug API, lisibilité |
| JSON → YAML | JSON valide | YAML formaté | Créer un docker-compose, manifest K8s |
| Formater YAML | YAML avec indentation irrégulière | YAML normalisé | Nettoyer une config avant commit |
| YAML → JSON | YAML valide | JSON indenté ou minifié | Préparer un payload API depuis une config YAML |
Cas d'usage concrets
Scénario 1 : Déboguer une réponse API
Symptôme : Vous recevez un payload JSON minifié de 500 caractères sur une seule ligne. Diagnostic : Collez le JSON et sélectionnez « Formater JSON ». Action : Le JSON est indenté et lisible. Identifiez le champ fautif en quelques secondes.
Scénario 2 : Convertir une config Terraform en YAML
Symptôme : Vous avez un output JSON d'un terraform output -json et devez l'intégrer dans un fichier YAML.
Diagnostic : Collez le JSON et sélectionnez « JSON → YAML ».
Action : Copiez le YAML généré directement dans votre fichier de config.
Scénario 3 : Valider un docker-compose.yml
Symptôme : Un docker compose up échoue avec une erreur de parsing.
Diagnostic : Collez le YAML et sélectionnez « Formater YAML ». Si le YAML est invalide, l'outil signale l'erreur.
Action : Corrigez l'erreur identifiée et relancez le déploiement.
❓ FAQ - Questions fréquentes
Q : Quelle est la taille maximale acceptée ?
R : L'outil accepte des documents JSON ou YAML jusqu'à 1 Mo. Pour des fichiers plus volumineux, utilisez jq (JSON) ou yq (YAML) en ligne de commande.
Q : L'outil valide-t-il la syntaxe JSON ?
R : Oui. Si le JSON est invalide, l'outil retourne une erreur explicite (ERR_INVALID_JSON_INPUT) avec un message descriptif.
Q : Quelle est la différence entre JSON et YAML ?
R : JSON utilise des accolades, des guillemets et des virgules. YAML utilise l'indentation et est plus lisible pour les humains. YAML est un surensemble de JSON.
Q : Que signifie minifier du JSON ?
R : Minifier supprime tous les espaces et retours à la ligne superflus pour obtenir un JSON compact sur une seule ligne.
Q : Comment l'outil gère-t-il les clés non-string en YAML ?
R : YAML autorise des clés numériques ou booléennes (true: value, 42: data). Lors de la conversion vers JSON, elles sont automatiquement converties en chaînes.
Q : Mes données sont-elles stockées ?
R : Non. Le contenu est traité en mémoire et supprimé immédiatement après la réponse.
Q : Puis-je utiliser cet outil pour valider un fichier Kubernetes ?
R : L'outil valide la syntaxe YAML, pas le schéma Kubernetes. Utilisez kubectl apply --dry-run pour la validation de schéma.
Outils complémentaires
| Outil | Utilité |
|---|---|
| Encodeur / décodeur Base64 | Encoder des payloads JSON en Base64 pour le transport |
| Encodeur / décodeur URL | Encoder du JSON dans une query string URL |
| Regex Tester | Extraire des valeurs d'un JSON avec des expressions régulières |
| Hash Generator | Calculer le hash d'un document JSON pour vérifier l'intégrité |
Ressources utiles
- RFC 8259 - The JSON Data Interchange Format (spécification officielle JSON)
- YAML 1.2 Specification (spécification officielle YAML)
- jq - Command-line JSON processor (outil CLI pour manipuler du JSON)
- yq - Command-line YAML processor (outil CLI pour manipuler du YAML)