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

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

03.08.2026

9 min de lecture

Partager cet article:

JSON

yaml

convert

DevOps

config

Tutoriel

Pourquoi passer du JSON au YAML (et l'inverse) ?

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

JSON → YAML pour manifests K8s, values Helm ou snippets Compose à partir d'exports API

YAML → JSON pour schémas CI, validateurs JSON Schema ou apps qui n'acceptent que JSON.parse

Beautify YAML après conversion — indentation 2 ou 4 espaces, style lisible ou compact

100 % local — configs et secrets ne quittent pas le navigateur

Workflow 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 committer.

Dates YAML (2026-08-03 sans guillemets) → rejetées en YAML → JSON ; quotez en chaîne

yes / no YAML → booléens ; en JSON ce sont des chaînes si vous les quotez à la source

Nombres avec zéros initiaux (01) → souvent interprétés comme chaîne en YAML

Tableaux vides vs clés absentes : JSON "tags": [] ≠ omission de clé en YAML

Multi-documents YAML : impossible en un seul passage — splittez manuellement

Round-trip et ordre des clés

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

L'ordre des clés suit le parseur ECMA — pas de tri alphabétique automatique

Commentaires YAML disparaissent au beautify — gardez-les dans un fichier séparé ou ajoutez-les après

Comparez avec json-diff après round-trip pour détecter les deltas inattendus

Option tri des clés sur le formateur JSON avant export si votre CI l'exige

Ne stockez pas de secrets dans les payloads de test — même en local, masquez-les en revue

Limites honnêtes des outils navigateur

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

Pas de validation OpenAPI, Kubernetes ou Compose spec sur ces pages

Fichiers très volumineux peuvent bloquer le thread principal du navigateur

Pas d'upload serveur — idéal pour la confidentialité, pas pour l'automatisation batch

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 : mêmes données, 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 (mappings), tableaux (séquences), chaînes, nombres, booléens et null. Une conversion correcte préserve la hiérarchie — un objet imbriqué reste imbriqué, 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 parse

Pas de commentaires en JSON — à ajouter manuellement en YAML après 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 pas les timestamps natifs YAML ni les documents multiples séparés par ---.

JSON : strict, un seul document racine, pas de virgule finale (sauf parsers tolérants)

YAML : indentation significative — une tabulation mal placée change la structure

YAML : types implicites (yes, no, dates ISO) → attention au round-trip

JSON : null explicite ; YAML peut confondre chaîne vide et null selon le contexte

Les ancres YAML sont résolues à l'import — le JSON résultant 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 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 des configs courtes avec beaucoup de commentaires métier.

Export CI JSON → brouillon YAML pour revue GitOps

Manifest K8s collé depuis la doc → JSON pour json-schema-validator ou diff

Fixture de test API → YAML pour playbook Ansible ou inventaire

Pivot intermédiaire : Properties/INI → JSON → YAML via les convertisseurs du site

Évitez la conversion pour du YAML multi-documents — un seul flux par passage

Convertisseurs et beautify : workflow pas à pas

JSON → YAML

Le convertisseur JSON vers YAML parse l'entrée avec le même moteur que le validateur JSON historique. JSON invalide → message explicite. Sortie YAML avec indentation déterministe, téléchargement .yaml immédiat.

Entrée : JSON valide uniquement — validez ou réparez en amont

Ordre des clés : reprend l'ordre d'insertion du parseur ECMA

Listes Kubernetes et objets imbriqués : hiérarchie conservée

Pas de commentaires injectés — ajoutez-les après conversion

Fichiers > 1 Mo : préférez un poste fixe (Chrome desktop)

YAML → JSON

Le convertisseur YAML vers JSON accepte un seul document YAML (flux multi-documents --- refusé). Types Date, BigInt et valeurs non sérialisables JSON sont rejetés avec erreur claire.

Un document par collage — séparez les manifests multi-fichiers

Ancres YAML résolues par js-yaml ; graphes cycliques → erreur de parse

Timestamps YAML natifs refusés — utilisez des chaînes ISO entre guillemets

Sortie JSON indentée — prête pour validateur, diff ou minify-json

Pas d'appel kubectl ni validation de schéma K8s — collage local uniquement

Beautifier YAML après conversion

La conversion produit du YAML fonctionnel ; le beautifier YAML uniformise l'indentation (2 ou 4 espaces), le style (lisible 80 colonnes ou compact) et les guillemets (minimaux ou doubles systématiques). Les commentaires ne survivent pas au parse — normal pour un flux beautify.

Indentation 2 ou 4 espaces — alignez sur le style du dépôt

Style lisible vs compact selon revue humaine ou embedding

Option guillemets : minimaux ou doubles pour cohérence d'équipe

Complément de json-to-yaml : convertir puis beautifier avant la PR

Pour minifier (retirer espaces) : minify-yaml sur le hub YAML

Scénario — Export API vers manifest Compose

Un microservice expose sa config runtime en JSON ; vous devez la versionner en YAML dans un dépôt GitOps.

Étape 1 : Valider le JSON source

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

Étape 2 : Convertir en YAML

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

Étape 3 : Beautifier et commit

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

Scénario — Manifest K8s vers fixture JSON Schema

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

Étape 1 : Un seul document

Retirez les séparateurs --- et ne gardez qu'un manifest. Multi-documents = erreur explicite sur yaml-to-json.

Étape 2 : YAML → JSON

Collez dans YAML → JSON. Remplacez les dates implicites par des chaînes si le parseur les rejette.

Étape 3 : Valider et comparer

Passez la sortie dans le validateur JSON, puis json-diff contre la fixture attendue — 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 configs sensibles sur un serveur tiers. Collez, convertissez, beautifiez — le tout localement. Enchaînez avec la validation JSON, le diff structurel et les outils DevOps quand vous préparez un déploiement.

Convertissez JSON et YAML maintenant

Validez toujours le JSON avant json-to-yaml

Un seul document YAML par passage vers yaml-to-json

Beautifiez après conversion pour des diffs de PR lisibles

Quotez les dates et booléens ambigus pour un round-trip fiable

Consultez le guide Terraform/HCL pour le voisin HCL du YAML DevOps

Partager cet article

Partager cet article: