Utilitaires

YAML et JSON

Convertir entre YAML et JSON dans les deux sens.

Ce que fait cet outil. Cet outil convertit du YAML en JSON et inversement. YAML utilise l’indentation pour marquer la structure, et c’est précisément là que cela casse — une tabulation au lieu d’espaces rend un fichier invalide.

Fonctionne dans le navigateurAucun envoiSans inscriptionFonctionne hors ligne

Comment utiliser YAML et JSON

Collez du YAML ou du JSON ; le format est reconnu.
Consultez le résultat ou l’erreur avec son numéro de ligne.
Copiez la sortie.

Indenter avec des espaces, jamais des tabulations

La règle la plus importante de YAML, et l’erreur la plus fréquente.

YAML n’admet pas les tabulations pour l’indentation. Uniquement des espaces. Un éditeur qui insère silencieusement des tabulations produit un fichier qui paraît correct et ne fonctionne pas.

Le message d’erreur est en outre souvent trompeur : il désigne une ligne plus bas, là où la structure finit vraiment par échouer.

Activez dans votre éditeur la conversion des tabulations en espaces, et rendez les blancs visibles si vous travaillez souvent avec du YAML.

Deux espaces par niveau est la convention courante. Plus important que le nombre : rester cohérent dans un même fichier.

Des valeurs que vous n’aviez pas voulues

YAML devine le type d’une valeur, et cela se retourne contre vous à quelques endroits.

Les valeurs « yes », « no », « on » et « off » sont lues comme des booléens dans les versions anciennes de YAML. Un code de pays « NO » pour la Norvège devient donc la valeur faux. Mettez ces valeurs entre guillemets.

Les nombres à zéro initial peuvent être interprétés en octal. Un numéro de version ou un code postal a sa place entre guillemets.

Une heure comme 12:30 peut être comprise autrement que comme du texte. Là encore, des guillemets.

Règle pratique : tout ce qui est un identifiant plutôt qu’une valeur calculable se met entre guillemets.

Quel format pour quel usage

YAML est plus agréable à écrire et à lire à la main : moins de ponctuation, des commentaires possibles, du texte multiligne sans échappement.

JSON est plus strict et donc plus sûr pour un échange entre systèmes. Pas de commentaires, pas de dépendance à l’indentation, moins de façons de mal interpréter.

En pratique : la configuration éditée par des humains en YAML, les données échangées entre systèmes en JSON.

Un point à retenir lors de la conversion : les commentaires YAML disparaissent au passage vers JSON, qui n’en connaît pas. C’est irrécupérable.

Tout se passe dans cette page.

Questions fréquentes

Pourquoi mon YAML est-il invalide ?

Le plus souvent une tabulation à la place d’espaces. YAML ne les admet pas pour l’indentation.

Pourquoi NO devient-il faux ?

YAML ancien lit yes, no, on et off comme des booléens. Mettez-les entre guillemets.

Combien d’espaces par niveau ?

Deux est la convention. La cohérence importe plus que le nombre.

Mes commentaires sont-ils conservés ?

Pas vers JSON, qui n’en connaît pas.

Quel format choisir ?

YAML pour la configuration humaine, JSON pour l’échange entre systèmes.

Mon fichier est-il transmis ?

Non.