Pourquoi les équipes passent du JSON au YAML
Le YAML se lit et se modifie plus facilement que le JSON : pas d'accolades, pas d'erreur de virgule finale, et la possibilité d'ajouter des commentaires. C'est pourquoi il s'est imposé pour les manifestes Kubernetes, les fichiers Docker Compose, les pipelines CI et de nombreuses configurations d'applications.
Ce convertisseur produit du YAML en style bloc avec une indentation de deux espaces. Les longues chaînes restent sur une seule ligne au lieu d'être repliées, et les valeurs que le YAML pourrait mal interpréter, comme des chaînes qui ressemblent à des nombres ou des booléens, sont automatiquement mises entre guillemets.
JSON ou YAML : comparaison rapide
| Caractéristique | JSON | YAML |
|---|---|---|
| Nom complet | JavaScript Object Notation | YAML Ain't Markup Language |
| Type | Données hiérarchiques | Données hiérarchiques |
| Création | Début des années 2000 (RFC 4627 en 2006) | 2001 |
| Créé par | Douglas Crockford ; aujourd'hui ECMA-404 et RFC 8259 | Clark Evans, Ingy döt Net et Oren Ben-Kiki |
| Structure | Objets et tableaux imbriqués | Dictionnaires et listes imbriqués par l'indentation |
| Commentaires | Non | Oui, avec # |
| Types de données | Chaîne, nombre, booléen, null, objet, tableau | Chaînes, nombres, booléens, null, dates, listes, dictionnaires |
| Idéal pour | API, applications web et réglages d'applis | Configuration de Kubernetes, pipelines CI et Docker Compose |
| Compatibilité | Tous les langages de programmation | La plupart des langages via des bibliothèques |
| Type MIME | application/json | application/yaml |
Comment convertir du JSON en YAML
Étape 1: Choisissez le fichier JSON
Déposez un fichier .json dans le convertisseur.
Étape 2: YAML est présélectionné
Laissez YAML comme sortie.
Étape 3: Convertissez
Le JSON est analysé et écrit en YAML dans l'ordre d'origine des clés.
Étape 4: Téléchargez
Enregistrez le fichier .yaml et ajoutez commentaires ou modifications à votre guise.
Style de sortie
Style bloc
Dictionnaires et listes utilisent l'indentation au lieu des accolades et crochets.
Pas de repli
Les longues chaînes restent sur une seule ligne.
Guillemets intelligents
Des chaînes comme "true", "1.10", "on" ou "NO" sont entre guillemets, pour que même les anciens analyseurs YAML 1.1 les lisent comme des chaînes.
Ordre conservé
Les clés apparaissent dans le même ordre que dans le JSON.
Où le JSON vers YAML trouve sa place
Manifestes Kubernetes. Transformez la sortie JSON de kubectl ou de générateurs en YAML modifiable.
Pipelines CI. Rédigez des configurations GitHub Actions ou GitLab CI à partir de modèles JSON.
Spécifications OpenAPI. Maintenez vos définitions d'API sous la forme YAML, plus lisible.
Réglages modifiés à la main. Donnez aux non-développeurs un fichier de configuration plus facile à lire.
Ajouter des commentaires après la conversion
L'une des principales raisons de passer au YAML, ce sont les commentaires. Le JSON ne peut pas en contenir : le fichier converti n'en a donc aucun au départ. Ajoutez des commentaires # au-dessus des clés pour expliquer pourquoi un réglage existe ; les analyseurs YAML les ignorent.
Gardez une indentation cohérente en modifiant le fichier : deux espaces par niveau, jamais de tabulation.
Les types sont conservés à l'identique
Les nombres restent des nombres, les booléens des booléens et null devient null. Les chaînes qui pourraient être prises pour un autre type sont mises entre guillemets : c'est ce qui garde une valeur comme "yes" ou "0123" en chaîne à la relecture du YAML.
Les objets et tableaux vides sont écrits en style en ligne, {} et [], le style bloc ne pouvant pas représenter le vide.
- "port": 8080 devient port: 8080.
- "version": "1.10" devient version: "1.10".
- "tags": [] devient tags: [].
Conseils pour le JSON vers YAML
- Validez le YAML avec l'outil cible : chaque outil a son propre schéma.
- Si le JSON est généré, conservez-le comme source et régénérez le YAML plutôt que de modifier les deux.
- Utilisez YAML vers JSON pour vérifier que l'aller-retour redonne les mêmes données.
- Répartissez les très grosses configurations dans plusieurs fichiers pour la lisibilité.
Questions sur la conversion JSON en YAML
Quelle indentation est utilisée ?
Deux espaces par niveau, la convention YAML la plus courante.
Les longues chaînes seront-elles repliées ?
Non. Le repli de lignes est désactivé : chaque chaîne reste sur une ligne.
L'ordre des clés est-il conservé ?
Oui, les clés apparaissent dans le même ordre que dans le JSON.
Pourquoi certaines chaînes sont-elles entre guillemets ?
Les guillemets sont ajoutés là où le YAML lirait sinon la valeur comme un nombre, un booléen ou null.
Le résultat peut-il contenir des commentaires ?
Le JSON n'a pas de commentaires à convertir, mais vous pouvez en ajouter au YAML ensuite.
Mon JSON est-il envoyé ?
Non. Tout se passe dans votre navigateur.