Comment convertir du JSON en YAML et du YAML en JSON (sans abîmer vos valeurs)
Convertissez du JSON en YAML ou du YAML en JSON pour Kubernetes, Docker Compose et la CI. Le problème de la Norvège, les pièges des tabulations et ce qui est perdu.
Mis à jour le 7 novembre 202610 min de lecture
Pour convertir du JSON en YAML, collez le JSON dans le convertisseur JSON vers YAML, choisissez l'analyseur pour lequel votre YAML est destiné et cliquez sur Convertir en YAML. Pour faire l'inverse, collez le YAML dans le convertisseur YAML vers JSON. Les deux prennent quelques secondes. Ce qui mérite d'être lu, c'est ce qui peut mal tourner : YAML devine le type des mots sans guillemets, si bien qu'un code pays comme no peut devenir false, une permission de fichier peut devenir un autre nombre et une date peut cesser d'être du texte. Ce guide couvre les deux sens, ces pièges et ce qui se perd en route.
Deux sens, deux outils
JSON et YAML décrivent les mêmes types de données : objets, listes, texte, nombres, vrai ou faux, et null. JSON est strict et bruyant, avec des accolades, des crochets et des guillemets partout. YAML supprime l'essentiel de tout cela et s'appuie sur l'indentation, ce qui explique sa préférence pour les fichiers que l'on modifie à la main. Chaque sens a son propre outil, avec ses propres limites.
| Vous avez | Vous voulez | Outil | Limite gratuite |
|---|---|---|---|
| Du JSON, une réponse d'API ou un export | Du YAML | JSON vers YAML | Un fichier jusqu'à 10 Mo |
| Une configuration ou un manifeste YAML | Du JSON | YAML vers JSON | Un fichier jusqu'à 25 Mo |
| Du JSON qui ne s'analyse pas | Du JSON corrigé | Validateur JSON | Voir la page de l'outil |
| Du JSON brouillon sur une seule ligne | Du JSON lisible | Formateur JSON | Voir la page de l'outil |
Les limites diffèrent parce que le travail diffère. Convertir du JSON en YAML oblige à garder tout le document sous forme d'objets en mémoire pendant l'écriture du YAML, et cet outil s'arrête donc à 10 Mo. La lecture du YAML parcourt le texte, ce qui laisse de la marge jusqu'à 25 Mo.
Convertir du JSON en YAML, pas à pas
Ajoutez votre JSON
Ouvrez le convertisseur JSON vers YAML. Collez le JSON dans l'éditeur et cliquez sur Utiliser ce JSON, ou déposez un fichier .json, .ndjson ou .jsonl sur la page.
Choisissez l'Analyseur cible
Le réglage par défaut est Portable : il met entre guillemets toute valeur qu'un lecteur YAML ancien ou gérant les dates lirait comme un autre type. YAML 1.2 ne met entre guillemets que ce dont un analyseur moderne a besoin. Tout entre guillemets entoure chaque chaîne lorsque vous ne savez pas ce qui lira le fichier.
Réglez la mise en page
Choisissez une Indentation de 1 à 8 espaces (2 par défaut), un Style de null parmi null, ~ ou vide, et si le fichier commence par ---.
Convertissez et lisez le badge
Cliquez sur Convertir en YAML. Avec Vérifier le résultat activé, le YAML est relu par un analyseur indépendant et comparé à votre JSON. Le badge indique Vérifié, ou nomme le premier chemin où une valeur est revenue différente.
Téléchargez ou copiez
Utilisez Télécharger le YAML ou Copier. L'aperçu affiche les premières lignes des gros fichiers, mais le téléchargement contient le résultat entier.
Convertir du YAML en JSON
Collez du YAML dans le convertisseur YAML vers JSON ou déposez un fichier .yaml ou .yml. Les boutons d'exemple Kubernetes, Docker Compose et GitHub Actions chargent un fichier typique pour que vous voyiez d'abord le résultat. Tous les réglages de sortie sont gratuits :
- Retrait : 2 espaces, 4 espaces, Tabulations ou Minifié (une ligne, sans espaces superflus).
- Documents : Automatique (un document devient un objet, plusieurs deviennent un tableau), Toujours un tableau, Premier seulement ou Fichiers séparés, un .json par document.
- Trier les clés : place les clés de chaque objet dans un ordre stable pour que deux conversions se comparent proprement.
- Clés en double : Refuser, qui indique la ligne, ou Garder la dernière.
- NaN et Infinity : Écrire null, En texte ou Arrêter. JSON n'a pas de valeur pour .nan ni .inf.
- Horodatages : Tels qu'écrits, ou ISO 8601.
Les ancres et les alias sont développés partout où ils sont utilisés, et les clés de fusion comme <<: *common sont résolues, les clés écrites directement dans un mapping l'emportant sur celles fusionnées. Les balises comme !Ref sont ramenées à la valeur qu'elles recouvrent, et leurs noms sont listés sous le résultat.
Choisissez l'analyseur, convertissez et obtenez un résultat vérifié. Gratuit : un fichier jusqu'à 10 Mo, avec tous les réglages qui touchent à l'exactitude. Pro : jusqu'à 50 fichiers dans un ZIP, plus le style de sortie. Tout s'exécute sur votre appareil, pas sur nos serveurs.
Convertir du JSON en YAMLLe problème de la Norvège et autres changements de type silencieux
En YAML 1.1, la version encore utilisée par PyYAML, Ansible et Psych de Ruby, les mots simples yes, no, on, off, y et n sont des booléens. Une liste de codes pays contenant NO (Norvège) revient donc avec false à sa place. Aucune erreur n'est signalée ; les données sont simplement fausses. YAML 1.2 a supprimé cette règle, de sorte que certains analyseurs lisent le même fichier autrement que d'autres. C'est ce désaccord que le réglage Analyseur cible est là pour gérer.
| Valeur dans votre JSON | Ce qu'un lecteur YAML ancien peut en faire | Cible Portable |
|---|---|---|
| "no", "yes", "on", "off" | Des booléens : "no" devient false | Entre guillemets |
| "0755" | Un nombre octal, 493 | Entre guillemets |
| "1:30" | Un nombre en base 60, 90 | Entre guillemets |
| "2024-01-01" | Un objet date, pas du texte | Entre guillemets |
| "true", "null", "12" | Un booléen, null ou un nombre, dans toutes les versions de YAML | Entre guillemets (dans tous les modes) |
| "hello" | Du texte | Laissé tel quel |
Portable met entre guillemets exactement les valeurs de ce tableau et laisse les mots ordinaires tranquilles, si bien que le fichier reste lisible. Le mode YAML 1.2 en met moins et n'est correct que si ce qui lit le fichier est un analyseur 1.2 sans gestion des dates ; l'outil compte tout de même combien de valeurs un lecteur ancien changerait et vous l'indique. Les clés suivent les mêmes règles, car une clé n ou yes sans guillemets devient un booléen dans un lecteur 1.1. Dans l'autre sens, YAML vers JSON applique les règles de YAML 1.2 : yes, no, on et off restent des chaînes, et un horodatage comme 2001-12-14 reste le texte que vous avez saisi, sauf si vous choisissez ISO 8601.
Indentation, tabulations et valeurs vides
La structure d'un YAML, c'est l'indentation. Deux espaces de plus signifient un enfant ; la même indentation signifie un frère. Une seule ligne décalée d'un espace de trop change la forme des données ou arrête l'analyse. Les tabulations sont l'échec classique : YAML les interdit pour l'indentation, et un fichier qui paraît aligné dans un éditeur avec des taquets de tabulation peut refuser de se charger. Le convertisseur YAML vers JSON indique la ligne et la colonne de la faute, avec quelques lignes de votre propre source et un curseur dessous. Remplacez la tabulation par des espaces et convertissez de nouveau.
JSON vers YAML ne présente pas ce risque, car l'outil écrit l'indentation à votre place. Les conteneurs vides sont écrits {} et [] au lieu d'être laissés vides, car une valeur vide est relue comme null. Un texte contenant des retours à la ligne devient un bloc | lisible, de sorte qu'un script ou un certificat garde ses lignes. Si un bloc ne peut pas représenter le texte exactement, par exemple quand la première ligne est vide ou indentée, ou qu'il contient un retour chariot, le texte est mis entre guillemets. Les changements silencieux sont pires qu'une sortie peu élégante.
Ce qui se perd en passant au JSON : commentaires et nœuds partagés
JSON n'a pas de commentaires. Quand vous convertissez du YAML en JSON, tous les commentaires # sont supprimés, et avec eux la documentation qu'ils portaient. Gardez le YAML comme source de référence et traitez le JSON comme un produit de compilation. En passant du JSON au YAML, vous pouvez écrire des commentaires, mais vous partez sans aucun : ajoutez-les après la conversion.
Les alias sont aussi aplatis. Deux endroits qui renvoyaient à une même ancre deviennent deux copies identiques dans le JSON, car JSON ne peut pas dire qu'il s'agissait du même nœud. Reconvertir donne un YAML plus long que l'original. Un alias circulaire, où une ancre se désigne elle-même, est du YAML légal mais impossible en JSON, et le convertisseur le signale avec le chemin plutôt que d'échouer en silence.
Usages typiques : Kubernetes, Docker Compose et fichiers de CI
- Kubernetes : un manifeste séparé par --- compte plusieurs documents. Utilisez Automatique ou Toujours un tableau pour les obtenir en JSON pour un outil qui l'attend, ou Fichiers séparés pour un .json chacun. Vers le YAML, réglez la mise en page puis surveillez le badge, car une étiquette de version comme "1.20" doit rester du texte.
- Docker Compose : un service défini avec <<: *common ressort avec les clés partagées déjà fusionnées. Les correspondances de ports comme "22:22" sont le piège de la version 1.1 en pratique, car un 22:22 nu peut être lu comme un nombre en base 60. Portable les met entre guillemets.
- Fichiers de CI comme les workflows GitHub Actions : la clé on reste la chaîne "on", pas true. C'est la bonne lecture pour un analyseur 1.2. Pour comparer deux fichiers de workflow, convertissez-les avec Trier les clés activé ; cela change l'ordre, pas le sens.
- Charges utiles d'API : transformez une réponse JSON en configuration YAML de départ, ou un fichier de réglages YAML en corps de requête pour un service qui ne lit pas le YAML.
Pour voir en quoi deux configurations diffèrent, convertissez les deux, triez les clés et comparez le JSON ; les changements d'ordre et de commentaires cessent alors d'apparaître comme des différences. Pour mettre d'abord le JSON en forme, voyez comment formater du JSON en ligne, et pour des sources XML, convertir du XML en JSON.
Quand la conversion échoue
Si le JSON ne peut pas être analysé, le convertisseur affiche la ligne et la colonne, un repère sous le caractère exact et ce qui était attendu à cet endroit. Les causes habituelles sont une virgule finale, des guillemets simples au lieu de doubles, un commentaire ou une clé sans guillemets. Le Validateur JSON liste les fautes en une seule passe, et le Formateur JSON rend la structure plus facile à voir. Corrigez la syntaxe, puis convertissez de nouveau.
- Fichier trop gros : les limites gratuites sont de 10 Mo pour JSON vers YAML et de 25 Mo pour YAML vers JSON. Découpez le fichier, ou passez à Pro.
- Plusieurs fichiers à la fois : Gratuit en convertit un à la fois. Pro en met jusqu'à 50 en file et les télécharge dans un seul ZIP ; YAML vers JSON peut aussi regrouper tous les documents de tous les fichiers dans un seul tableau.
- Clés en double dans le YAML : par défaut, la conversion est refusée et la seconde clé est nommée. JSON ne peut pas contenir les deux ; choisissez Garder la dernière seulement si vous savez quelle valeur vous voulez.
- Une valeur différente après conversion : le message Échec de la vérification indique le chemin et les deux types, par exemple une chaîne revenue sous forme de date. Passez l'Analyseur cible sur Portable.
Questions fréquentes
Comment convertir du JSON en YAML ?
Collez votre JSON dans le convertisseur JSON vers YAML, choisissez un Analyseur cible (Portable par défaut) et cliquez sur Convertir en YAML. Téléchargez ensuite le fichier .yaml ou copiez-le. La version gratuite traite un fichier jusqu'à 10 Mo.
Comment convertir du YAML en JSON ?
Collez du YAML ou déposez un fichier .yaml ou .yml dans le convertisseur YAML vers JSON. Choisissez le retrait, le traitement de plusieurs documents et le tri éventuel des clés, puis téléchargez le résultat. La version gratuite traite un fichier jusqu'à 25 Mo.
Qu'est-ce que le problème de la Norvège en YAML ?
En YAML 1.1, le mot no sans guillemets est un booléen, donc le code pays NO de la Norvège est lu comme false. Mettre la valeur entre guillemets règle le problème. Le convertisseur JSON vers YAML le fait pour vous quand l'Analyseur cible est Portable.
Les commentaires sont-ils conservés quand je convertis du YAML en JSON ?
Non. JSON n'a pas de commentaires, donc tous les commentaires # sont supprimés. Gardez le YAML comme source et générez le JSON à partir de lui, plutôt que de modifier le JSON à la main.
Pourquoi mon YAML échoue-t-il avec une erreur de tabulation ?
YAML n'autorise pas les tabulations pour l'indentation, même si le fichier paraît aligné dans votre éditeur. Remplacez les tabulations par des espaces. Le convertisseur YAML vers JSON indique la ligne et la colonne où il s'est arrêté.
Puis-je convertir des fichiers Kubernetes ou Docker Compose ?
Oui. Un manifeste de plusieurs documents séparés par --- se convertit en tableau, en son premier document ou en un fichier par document. Les ancres, alias et clés de fusion sont résolus. Tout s'exécute sur votre appareil, pas sur nos serveurs, donc les noms d'hôte et d'images ne sont pas envoyés.