JSON vers YAML : quand convertir, pièges et outils en ligne

JSON vers YAML : quand convertir, pièges et outils en ligne

Config K8s, CI/CD, Ansible : convertissez JSON ↔ YAML dans le navigateur sans perdre la structure ni les types.

03.08.2026
9 min de lecture
Partager cet article:
JSONYAMLconvertDevOpsconfigTutoriel

Passer du JSON au YAML, et inversement

Le JSON domine les API, les exports de tableaux de bord et les jeux de test. Le YAML reste le format de prédilection pour Kubernetes, GitHub Actions, GitLab CI, Ansible et Docker Compose. Il est plus lisible, avec moins de guillemets et une indentation naturelle. Quand un pipeline produit du JSON, mais qu'une relecture humaine ou un manifeste attend du YAML, la conversion doit préserver la hiérarchie sans surprise de type. Le convertisseur JSON vers YAML et le convertisseur YAML vers JSON de FastMinify s'exécutent entièrement dans le navigateur, sans aucun envoi à un serveur. Après la conversion, le beautifier YAML normalise l'indentation pour une PR propre. Ces outils complètent le hub outils DevOps et la famille JSON. Si votre entrée JSON est invalide, commencez par le guide valider et réparer du JSON. Pour l'IaC de HashiCorp, voir aussi le guide Terraform et HCL.

JSON → YAML pour des manifestes K8s, des values Helm ou des extraits Compose issus d'exports d'API
YAML → JSON pour des applications qui n'acceptent que JSON.parse, des schémas de CI ou des validateurs JSON Schema
Beautifier le YAML après la conversion, avec une indentation de 2 ou 4 espaces et un style lisible ou compact
100 % local : configurations et secrets ne quittent pas le navigateur
Enchaînement complet : valider → convertir → beautifier → commit ou diff

Pièges de types et bonnes pratiques

Erreurs de type les plus fréquentes

La conversion structurelle ne garantit pas l'équivalence sémantique dans tous les écosystèmes. Anticipez ces écarts avant de faire le commit.

Dates YAML (2026-08-03 sans guillemets) → rejetées en YAML → JSON ; mettez-les entre guillemets pour en faire des chaînes
yes / no sont des booléens pour les analyseurs YAML 1.1, mais de simples chaînes en YAML 1.2 : mettez-les entre guillemets pour lever l'ambiguïté
Les nombres à zéros initiaux (01) sont lus différemment d'un analyseur à l'autre : mettez-les entre guillemets s'il s'agit d'identifiants
Tableaux vides et clés absentes : JSON "tags": [] ≠ clé omise en YAML
Le YAML de plusieurs documents est impossible en un seul passage : séparez-le à la main
Aller-retour et ordre des clés

JSON → YAML → JSON peut réordonner les clés ou perdre des commentaires. Pour des diffs stables, normalisez avant de comparer.

L'ordre des clés suit l'analyseur ECMA, sans tri alphabétique automatique
Les commentaires YAML disparaissent au beautify : gardez-les dans un fichier séparé ou ajoutez-les après
Comparez avec json-diff après l'aller-retour pour repérer les écarts inattendus
Activez le tri des clés sur le formateur JSON avant l'export si votre CI l'exige
Ne stockez pas de secrets dans les payloads de test, et masquez-les en relecture même en local
Limites honnêtes des outils du navigateur

FastMinify convertit et formate, mais il ne remplace pas kubectl apply, terraform validate ni un linter de CI complet.

Aucune validation OpenAPI, Kubernetes ou Compose sur ces pages
Les fichiers très volumineux peuvent bloquer le thread principal du navigateur
Rien n'est envoyé à un serveur, ce qui sert la confidentialité, mais pas l'automatisation par lots
Ancres et alias YAML : résolus à l'import ; vérifiez le JSON aplati
Pour l'IaC Terraform/HCL, utilisez les outils dédiés du hub DevOps

JSON et YAML expriment les mêmes données avec des syntaxes différentes

Ce que les deux formats partagent

JSON et YAML 1.2 (via js-yaml) représentent les mêmes structures de base : objets, tableaux, chaînes, nombres, booléens et null. Le YAML appelle les objets des mappings et les tableaux des séquences. Une conversion correcte préserve la hiérarchie, donc un objet imbriqué reste imbriqué et un tableau reste un tableau.

Objets : clés/valeurs en JSON → paires indentées en YAML
Tableaux : ["a", "b"] → liste à tirets - a
Chaînes : guillemets souvent optionnels en YAML sauf ambiguïté
Nombres et booléens : mêmes valeurs sémantiques après l'analyse
Le JSON n'a pas de commentaires : ajoutez-les à la main dans le YAML après la conversion
Où la syntaxe diverge

YAML autorise des raccourcis (blocs flow {key: value}, ancres &ref) que JSON ignore. À l'inverse, JSON impose des guillemets sur les clés et n'admet ni les horodatages natifs de YAML ni plusieurs documents séparés par ---.

JSON : strict, un seul document racine, pas de virgule finale (sauf analyseurs tolérants)
YAML : l'indentation est significative, donc une tabulation mal placée change la structure
YAML : types implicites (yes, no, dates ISO) → attention au comportement à l'aller-retour
JSON : null explicite ; YAML peut confondre chaîne vide et null selon le contexte
Les ancres YAML sont résolues à l'import, donc le JSON obtenu est aplati, sans références
Quand convertir plutôt que réécrire

La conversion automatique gagne du temps quand la source est déjà structurée : export Postman, réponse d'API capturée, fichier .tf.json ou values Helm générées par un outil. Réécrire à la main reste préférable pour de petites configurations qui portent beaucoup de commentaires métier.

Export JSON de CI → brouillon YAML pour une relecture GitOps
Manifeste K8s collé depuis la documentation → JSON pour json-schema-validator ou diff
Jeu de test d'API → YAML pour un playbook ou un inventaire Ansible
Passage par un format intermédiaire : Properties/INI → JSON → YAML avec les convertisseurs du site
Évitez la conversion pour du YAML de plusieurs documents : un seul flux par passage

Convertisseurs et beautify pas à pas

JSON → YAML

Le convertisseur JSON vers YAML analyse l'entrée avec le même moteur que le validateur JSON historique. Un JSON invalide donne un message explicite. La sortie YAML a une indentation déterministe et se télécharge au format .yaml.

Entrée : JSON valide uniquement, donc validez ou réparez en amont
Ordre des clés : celui d'insertion de l'analyseur ECMA
Listes Kubernetes et objets imbriqués : hiérarchie conservée
Aucun commentaire n'est injecté : ajoutez-les après la conversion
Fichiers de plus de 1 Mo : préférez un ordinateur de bureau (Chrome recommandé)
YAML → JSON

Le convertisseur YAML vers JSON accepte un seul document YAML, et les flux de plusieurs documents séparés par --- sont refusés. Les types Date, BigInt et les valeurs qui ne peuvent pas être sérialisées en JSON sont rejetés avec une erreur claire.

Un document par collage : séparez les manifestes de plusieurs fichiers
Ancres YAML résolues par js-yaml ; graphes cycliques → erreur d'analyse
Les horodatages YAML natifs sont refusés : utilisez des chaînes ISO entre guillemets
Sortie JSON indentée, prête pour le validateur, diff ou minify-json
Aucun appel à kubectl ni validation de schéma K8s, uniquement un collage local
Beautifier le YAML après la conversion

La conversion produit du YAML fonctionnel. Le beautifier YAML uniformise ensuite l'indentation, le style et les guillemets. Vous choisissez 2 ou 4 espaces, une mise en page lisible sur 80 colonnes ou compacte, des guillemets minimaux ou toujours doubles. Les commentaires ne survivent pas à l'analyse, ce qui est normal pour un passage par le beautify.

Indentation de 2 ou 4 espaces, à aligner sur le style du dépôt
Style lisible ou compact, selon la relecture humaine ou l'intégration
Option de guillemets : minimaux ou doubles, pour la cohérence de l'équipe
Complément de json-to-yaml : convertir puis beautifier avant la PR
Pour minifier (retirer les espaces) : minify-yaml sur le hub YAML
D'un export d'API à un manifeste Compose

Un service expose sa configuration d'exécution en JSON, et vous devez la versionner en YAML dans un dépôt GitOps.

1

Validez le JSON source

Collez l'export dans le validateur JSON. Erreur de syntaxe ? Passez par json-repair ou corrigez manuellement.

2

Convertissez en YAML

Ouvrez JSON → YAML et cliquez sur Convertir. Vérifiez visuellement la hiérarchie : services, ports, variables d'environnement.

3

Beautifiez et faites le commit

Collez la sortie dans beautify YAML avec la même indentation que le reste du dépôt. Téléchargez-la ou copiez-la pour la PR.

D'un manifeste K8s à un jeu de test JSON Schema

Vous avez un extrait YAML Helm et devez le valider contre un schéma JSON en CI.

1

Gardez un seul document

Retirez les séparateurs --- et ne gardez qu'un manifeste. Plusieurs documents donnent une erreur explicite sur yaml-to-json.

2

Convertissez le YAML en JSON

Collez dans YAML → JSON. Remplacez les dates implicites par des chaînes si l'analyseur les rejette.

3

Validez et comparez

Passez la sortie dans le validateur JSON, puis dans json-diff contre le jeu de test attendu, et voir le guide formatter, diff et tree viewer.

Conclusion

Convertir entre JSON et YAML ne devrait pas imposer d'installer jq, yq ou d'envoyer des configurations sensibles à un serveur tiers. Collez, convertissez, beautifiez, le tout en local. Enchaînez avec la validation JSON, le diff structurel et les outils DevOps quand vous préparez un déploiement.

Convertissez maintenant votre JSON et votre YAML

Validez toujours le JSON avant json-to-yaml
Un seul document YAML par passage dans yaml-to-json
Beautifiez après conversion pour des diffs de PR lisibles
Mettez entre guillemets les dates et booléens ambigus pour un aller-retour fiable
Consultez le guide Terraform/HCL pour le HCL qui accompagne le YAML DevOps
Partager cet article
Partager cet article: