Convertisseur JSON en YAML

Comment convertir du JSON en YAML

1. Choisissez le sens : JSON → YAML ou YAML → JSON.
2. Collez vos données ou cliquez sur Ouvrir un fichier pour charger un fichier .json, .yaml ou .yml (10 Mo au maximum).
3. Choisissez l’Indentation (2 ou 4 espaces) et, si vous le souhaitez, cochez Trier les clés pour les classer par ordre alphabétique.
4. Cliquez sur Convertir, ou continuez simplement à taper : le résultat se met à jour tout seul. Si la saisie est invalide, le message d’erreur indique la ligne et la colonne du problème.
5. Copiez ou téléchargez le résultat. Inverser le sens renvoie le résultat dans la zone de saisie pour la conversion inverse.

JSON et YAML : les mêmes données, deux syntaxes

En pratique, YAML englobe JSON : tout ce qu’un document JSON décrit peut s’écrire en YAML, avec une syntaxe plus légère, plus facile à lire et à modifier à la main. C’est pourquoi les manifestes Kubernetes, les fichiers Docker Compose, les workflows GitHub Actions, les pipelines GitLab CI, les playbooks Ansible et les spécifications OpenAPI sont généralement écrits en YAML, alors que les API et les programmes échangent du JSON.

Les mêmes données dans les deux formats :

{"nom": "web", "ports": [80, 443], "env": {"DEBUG": false}}

nom: web
ports:
  - 80
  - 443
env:
  DEBUG: false

Du JSON vers le YAML

L’outil produit du YAML en style bloc : une clé par ligne, des listes à tirets et des objets imbriqués indentés. Les longues chaînes ne sont jamais repliées, et les chaînes sur plusieurs lignes utilisent le style littéral |, qui conserve les retours à la ligne à l’identique. Les chaînes que YAML lirait autrement comme un autre type sont mises entre apostrophes : "yes", "1.0" ou "null" restent bien des chaînes après un aller-retour. Trier les clés classe les clés de chaque objet par ordre alphabétique, ce qui facilite la comparaison de deux fichiers de configuration.

Du YAML vers le JSON

Le YAML est lu selon le schéma « core » de YAML 1.2, les règles qu’appliquent la plupart des outils récents :

• true/false, les nombres et null (ou ~) deviennent des valeurs JSON ; yes, no, on et off restent des chaînes, comme l’exige la spécification YAML 1.2.
• Les ancres et alias (&base, *base) sont développés, et les clés de fusion (<<: *base), fréquentes dans les fichiers d’intégration continue, sont prises en charge.
• Un fichier contenant plusieurs documents séparés par --- devient un tableau JSON avec un élément par document ; un message indique combien de documents ont été regroupés.
• Les commentaires disparaissent, puisque JSON n’en accepte pas.
• .inf et .nan n’ont pas d’équivalent en JSON : ils sont écrits sous forme de chaînes, "Infinity" et "NaN".

Pour protéger votre navigateur des fichiers de type « billion laughs », où quelques alias se développent en milliards de valeurs, un document qui dépasse un million de valeurs une fois développé est refusé.

Les erreurs YAML les plus courantes

• Tabulations dans l’indentation : YAML n’accepte que des espaces.
• Indentation incohérente : les éléments d’une même liste ou d’un même objet doivent commencer à la même colonne.
• Espace manquante après les deux-points : cle:valeur est une simple chaîne, alors que cle: valeur est une paire clé-valeur.
• Caractères spéciaux sans guillemets : une valeur qui commence par @, un accent grave, *, & ou !, ou qui contient : ou #, doit être entre guillemets.