Convertir un JSON en YAML JavaScript Object Notation ↔ YAML Ain't Markup Language Gratuit En ligne Sûr
Déposez un fichier JSON et repartez avec du YAML. La lecture et l'écriture se font ici, dans votre navigateur : le fichier ne quitte pas votre appareil — et ce que le passage garde, et ce qu'il ne peut pas, est écrit plus bas plutôt que laissé à votre découverte.
Convertissez votre fichier
Déposez ici un fichier JSON, ou choisissez-en un.
Votre fichier ne quitte pas cet appareil. Tout tourne dans votre navigateur.
Rien n'est envoyé
Convertir depuis JSON
Convertir vers JSON
D'où viennent ces formats
Le CSV est le plus ancien et le moins normalisé : un tableau écrit en lignes de texte, en usage depuis les années 1970 et décrit par écrit seulement en 2005, alors que chaque logiciel avait déjà décidé pour lui-même quel était le séparateur et quand mettre des guillemets. XML sortit de SGML en 1998, pour des documents devant porter une structure stricte et être vérifiés contre un schéma. JSON fut extrait de JavaScript par Douglas Crockford vers 2001, volontairement réduit aux objets, aux listes, aux nombres et aux chaînes — et ce dépouillement est la raison de sa conquête du web. YAML en est le cousin lisible, où l'indentation fait le travail que les accolades font ailleurs. Une seule chose compte en convertissant entre eux : le CSV est plat, une grille de lignes et de colonnes, tandis que JSON, XML et YAML sont des arbres.
Où vous les rencontrez
Le CSV est ce qu'exporte un tableur et ce que vous tendent un comptable, une plateforme de boutique ou un relevé bancaire. JSON est ce que parlent les services web et ce dans quoi s'écrivent de plus en plus les fichiers de configuration. XML survit dans les systèmes d'entreprise anciens, dans les normes de facturation et à l'intérieur même des formats bureautiques. YAML est là où des humains écrivent des réglages à la main. Convertir entre eux est le travail quotidien qui déplace les données de leur lieu de production vers leur lieu d'emploi.
Questions fréquentes
Mon CSV s'est ouvert en une seule colonne dans Excel. Pourquoi ?
Parce que votre tableur attendait un autre séparateur. Excel suit le séparateur de liste des paramètres régionaux : un point-virgule partout où la virgule sert déjà de signe décimal, c'est-à-dire dans une grande partie de l'Europe continentale. Un fichier séparé par des virgules apparaît alors comme une colonne de texte. Employez la boîte d'importation et déclarez le séparateur, plutôt que d'ouvrir le fichier d'un double clic. Ce même paramètre régional explique que 3.5 arrive parfois sous forme de date.
Pourquoi mon JSON imbriqué ne devient-il pas un tableur propre ?
Parce qu'un tableur est plat et que JSON est un arbre. Une ligne contient une valeur par colonne ; un objet JSON peut contenir une liste dans un champ dans une autre liste. Convertir, c'est choisir comment aplatir cela : soit coller les noms imbriqués en un long intitulé de colonne, soit répéter la ligne parente une fois par enfant. Les deux sont des compromis, et aucun ne se défait automatiquement — d'où le fait que revenir du tableur à la forme d'origine demande d'ordinaire une décision humaine.
Le fichier perd-il en qualité ?
Cela dépend de ce que les deux formats peuvent contenir. Convertir entre des formats qui gardent la même chose — un PNG en BMP, un WAV en FLAC — ne perd rien. Convertir vers un format qui jette de l'information pour gagner de la place, comme JPEG ou MP3, en perd un peu à chaque fois, et revenir en arrière ne la ramène pas. Là où un choix existe, cette page penche pour conserver la qualité d'origine plutôt que pour produire le plus petit fichier.
Mon fichier est-il envoyé quelque part ?
Non. La conversion se fait dans votre navigateur, sur votre propre machine ; le fichier ne la quitte jamais et il n'y a ici aucun serveur qui pourrait le recevoir. C'est pourquoi un gros fichier est limité par votre mémoire et non par un envoi, et pourquoi rien de ce que vous convertissez ne peut figurer dans les journaux de qui que ce soit — les nôtres compris. Les outils de son et de vidéo vont toutefois chercher leur moteur de conversion sur ce site à la première utilisation — une trentaine de mégaoctets, une seule fois ; ensuite le travail se fait toujours entièrement sur votre machine.
Pourquoi on convertit un JSON en YAML
Le JSON est la notation que les programmes adorent : stricte, compacte et comprise par tous les langages. Mais elle n'est pas aimable envers les humains. Un long fichier JSON est un fourré d'accolades, de crochets, de guillemets et de virgules, sans place pour un commentaire et avec une virgule finale qui peut tout casser. Le YAML est la notation que les gens choisissent quand ils doivent lire et modifier des données à la main. Il utilise l'indentation à la place des accolades, autorise les commentaires et se lit presque comme un plan, ce qui explique qu'il soit devenu le favori de la configuration : chaînes de compilation, définitions de conteneurs, fichiers de déploiement, réglages de sites statiques et d'outils de documentation. Quand des données arrivent en JSON et que vous voulez travailler avec elles sous une forme agréable à lire, une conversion est nécessaire. C'est pourquoi on convertit des JSON en YAML.
Les situations sont quotidiennes. Un développeur qui a la sortie d'un outil en JSON et veut en faire un fichier de configuration. Une équipe qui déplace des réglages d'un système à un autre et préfère un format lisible. Un rédacteur qui veut lire la structure d'une réponse d'API sans l'encombrement. Une étudiante qui veut voir comment les accolades se traduisent en indentation. Dans chaque cas, les données sont les mêmes, et seule la notation change.
Cette page convertit le JSON en YAML dans votre navigateur. Votre fichier est lu et écrit ici et ne quitte donc jamais votre appareil, ce qui compte pour les fichiers de configuration, qui contiennent souvent des adresses, des noms de systèmes internes et parfois des secrets. Et la page vous dit à l'avance ce que le passage conserve et ce qu'il ne peut pas conserver, au lieu de vous laisser le découvrir. Vous trouverez plus bas comment fonctionne la conversion, ce qui se passe avec une imbrication profonde et de longues chaînes, et comment obtenir un résultat net.
Comment fonctionne la conversion
Les mêmes formes dans les deux notations
Votre JSON est lu dans votre navigateur, et sa structure est écrite en YAML. Les deux contiennent les mêmes formes, et tout est conservé dans les deux sens : dictionnaires, listes, chaînes, nombres, booléens et null. Un objet en JSON devient un mapping en YAML, un tableau devient une séquence, et les valeurs scalaires gardent leurs types. Une clé port avec le nombre 8080 donne port: 8080, et une clé enabled avec true donne enabled: true.
Les structures répétées sont écrites en entier
Le YAML a un moyen d'éviter la répétition, avec les ancres et les alias. Le convertisseur ne l'utilise pas. Les structures répétées sont écrites en entier plutôt que sous forme d'ancres ; le fichier se lit donc tout droit, de haut en bas. Cela rend le YAML un peu plus long, mais rien n'y demande d'être cherché ailleurs, et tout lecteur peut comprendre chaque bloc isolément.
Les clés gardent leur ordre
Les clés gardent leur ordre tel que le JSON l'avait. Le YAML se lit dans la même séquence que la source ; quiconque connaît le JSON s'y retrouvera aussitôt.
Ce qui est conservé
Tout ce qui est donnée
Tout est conservé, dans les deux sens : dictionnaires, listes, chaînes, nombres, booléens et null. Si c'était une valeur dans votre JSON, c'est une valeur dans le YAML, avec le même type.
Les chaînes qui ont besoin de protection
Certaines chaînes seraient mal lues en YAML si on les écrivait nues : le mot true, un nombre entre guillemets, un texte contenant deux-points. Le convertisseur met ces chaînes entre guillemets pour qu'elles reviennent comme des chaînes et ne deviennent pas des booléens ou des nombres. Une chaîne JSON qui dit « true » reste une chaîne dans le YAML.
Unicode
Les lettres accentuées, les symboles et les caractères d'autres alphabets sont conservés tels quels ; un fichier en plusieurs langues reste donc lisible.
Ce qu'il faut savoir avant de convertir un JSON en YAML
Une imbrication profonde signifie une indentation profonde
Le YAML met du sens dans son indentation ; une valeur qui se retrouve profondément imbriquée donne donc un fichier profondément indenté : lisible, mais pas court. Un arbre JSON de huit niveaux donne des lignes qui commencent loin de la marge gauche. Si cela devient peu maniable, envisagez d'aplatir la structure à sa source.
Les longues chaînes sont coupées
Les longues chaînes sont coupées vers cent colonnes, ce qui change l'endroit où tombent les sauts de ligne sans changer la valeur. Un paragraphe qui était une seule longue ligne dans le JSON apparaît sur plusieurs lignes dans le YAML, mais c'est le même texte. Un programme qui lit le YAML reçoit la chaîne d'origine.
Les commentaires ne peuvent pas être inventés
Le YAML autorise les commentaires, mais le JSON n'en porte aucun ; le résultat n'en a donc pas. Vous pouvez ajouter des explications à la main ensuite, ce qui est l'une des principales raisons d'avoir le fichier en YAML.
Comment convertir un JSON en YAML ici
Ajoutez votre fichier
Déposez le fichier JSON sur la page ou choisissez-le sur votre appareil. Il est lu dans votre navigateur et n'est pas envoyé.
Convertissez
Appuyez sur le bouton. Un fichier de taille ordinaire prend un instant. Laissez la page ouverte jusqu'à la fin.
Téléchargez et vérifiez
Téléchargez le YAML et ouvrez-le dans un éditeur de texte. Regardez le début et la fin, et vérifiez que la structure et les types sont ceux que vous attendez.
Un regard plus attentif sur le JSON et le YAML
Deux notations pour les mêmes données
Le JSON a été conçu pour être facile à lire et à écrire pour les programmes. Le YAML a été conçu pour être facile à lire pour les humains. Ils se recouvrent à tel point que le JSON est presque un sous-ensemble du YAML, et qu'un lecteur YAML peut généralement lire du JSON. Convertir un JSON en YAML, ce n'est donc pas changer les données mais les rhabiller, sous une forme qui a de la place pour des notes et pas d'encombrement de ponctuation.
Pourquoi l'indentation demande du soin
Comme le YAML repose sur l'indentation, une ligne mal alignée change le sens. Le convertisseur écrit l'indentation de façon cohérente, avec des espaces et la même largeur à chaque niveau ; le fichier est donc correct tel que produit. Quand vous le modifierez plus tard, gardez la même largeur et évitez les tabulations, que le YAML n'autorise pas pour l'indentation.
Lisible mais pas toujours plus court
On décrit souvent le YAML comme plus compact que le JSON, parce qu'il supprime les accolades et les guillemets autour des clés. Pour des données plates, c'est vrai. Pour des données profondément imbriquées, l'indentation peut le rendre plus long en caractères. Le gain est dans la lisibilité, pas dans la taille.
Situations courantes en détail
Transformer la sortie d'un outil en configuration
Les outils impriment souvent leurs réglages ou leurs résultats en JSON. Convertissez le JSON en YAML, ajoutez des commentaires et gardez-le comme fichier de configuration que des personnes entretiennent.
Déplacer des réglages entre systèmes
Déplacer une configuration d'un système qui utilise le JSON vers un système qui utilise le YAML se résume à une conversion, suivie d'une vérification que la cible accepte les clés.
Lire une réponse d'API
La réponse d'une API peut couvrir des centaines de lignes d'accolades. En YAML, les mêmes données se lisent comme un plan, et l'on voit la structure d'un coup d'œil.
Enseignement et documentation
Montrer les mêmes données dans les deux notations est un bon moyen d'enseigner comment fonctionnent les données structurées. Une documentation qui utilise des exemples YAML est souvent plus facile à lire.
Conseils pratiques avant de convertir un JSON en YAML
Vérifiez que le JSON est valide
Une virgule égarée ou un guillemet manquant arrêtera la conversion. Si la page signale une erreur, ouvrez le fichier dans un éditeur qui met en évidence les problèmes JSON et corrigez la ligne qu'il indique.
Aplatissez là où vous le pouvez
Si la structure est plus profonde que nécessaire, simplifiez-la d'abord. Une structure plus plate donne un YAML plus facile à lire et à modifier.
Pensez au consommateur
Regardez ce qui lira le YAML. Certains outils attendent des noms de clés et des types particuliers, et il est plus facile d'ajuster le JSON avant que de modifier le YAML après.
Gros fichiers
Tout s'exécute sur votre appareil ; un très gros fichier demande donc de la mémoire. Pour des fichiers de plusieurs mégaoctets, utilisez un ordinateur et scindez les données si la page peine.
Questions que l'on se pose avant de convertir
Mes données seront-elles modifiées ?
Non. Tout est conservé dans les deux sens : dictionnaires, listes, chaînes, nombres, booléens et null.
Pourquoi mes longues chaînes sont-elles réparties sur plusieurs lignes ?
Les longues chaînes sont coupées vers cent colonnes. Cela change l'endroit où tombent les sauts de ligne sans changer la valeur.
Pourquoi mon fichier est-il si indenté ?
Parce que les données sont profondément imbriquées, et que le YAML exprime l'imbrication par l'indentation.
Où sont les ancres ?
Les structures répétées sont écrites en entier plutôt que sous forme d'ancres ; le fichier se lit donc tout droit, de haut en bas.
Mon fichier est-il envoyé ?
Non. La conversion s'exécute dans votre navigateur et le fichier ne quitte jamais votre appareil.
Puis-je revenir au JSON ?
Oui. Convertir un YAML en JSON relit le fichier, mais les commentaires que vous aurez ajoutés ne survivront pas.
Bien choisir quand vous convertissez un JSON en YAML
Le YAML est-il vraiment nécessaire ?
Si l'outil destinataire lit le JSON, gardez le JSON. Convertissez quand des personnes doivent lire et modifier le fichier, ou quand l'outil exige du YAML.
Autres destinations
Si la destination est un fichier de balisage, Convertir un JSON en XML peut suivre. Pour les tableaux, Convertir un JSON en CSV et Convertir un JSON en XLSX servent les tableurs.
Gardez le JSON
Le JSON est l'original de référence s'il vient d'un programme. Gardez-le et régénérez le YAML quand il change.
Obtenir un bon résultat après la conversion
Ajoutez des commentaires
Le résultat n'en a aucun, et c'est là que le YAML brille. Ajoutez une courte note au-dessus de chaque bloc pour dire ce qu'il fait et quelles valeurs sont permises.
Vérifiez les types
Regardez des valeurs comme les versions, les codes et les indicateurs. Assurez-vous que ce sont des chaînes là où vous vouliez des chaînes et des nombres là où vous vouliez des nombres.
Gardez une indentation cohérente
Quand vous modifiez, utilisez des espaces et gardez la même largeur à chaque niveau. Un éditeur qui montre les espaces et vérifie le YAML vous épargnera des erreurs.
Préparer votre JSON pour qu'il se convertisse bien
Gardez-le régulier
Quand vous convertissez un JSON en YAML, les données régulières se convertissent le mieux : des clés cohérentes et des types clairs. Des données irrégulières donnent un résultat correct mais peu net.
Nommez clairement les clés
Des personnes liront le YAML ; choisissez donc des clés qui disent ce qu'elles signifient. Une configuration est plus facile à entretenir quand ses noms sont simples.
Testez d'abord sur un petit morceau
Si votre fichier est gros, prenez une section dans un fichier d'essai et convertissez-la. Un coup d'œil rapide au résultat montre si la structure est celle que vous attendez.
Travailler avec le YAML après avoir converti le JSON en YAML
Ajoutez les notes que le JSON ne pouvait pas porter
La première chose à faire avec un fichier fraîchement converti est de le lire depuis le haut et d'ajouter des commentaires là où un inconnu serait perplexe. Une courte ligne au-dessus d'une section, disant ce qu'elle commande, vaut plus qu'une page de documentation rangée ailleurs, parce qu'elle se trouve à côté de ce qu'elle décrit. C'est le principal avantage que vous gagnez en convertissant un JSON en YAML.
Regroupez les réglages apparentés
Les clés gardent l'ordre qu'elles avaient dans le JSON, qui peut être l'ordre dans lequel un programme les a émises par hasard. En YAML, vous êtes libre de les réorganiser pour que les réglages apparentés soient ensemble, avec une ligne vide entre les groupes. Comme l'ordre des clés dans un mapping n'a pas de sens pour la plupart des lecteurs, c'est sans risque, mais vérifiez l'outil que vous utilisez au cas où il y tiendrait.
Vérifiez ce qu'attend l'outil destinataire
Un fichier YAML valide n'est pas forcément une configuration valide. Les outils attendent des clés et des types particuliers, et certains sont stricts sur les clés inconnues. Après la conversion, comparez le fichier à la documentation de l'outil et lancez son propre vérificateur s'il en a un.
Utilisez la gestion de versions
Une configuration en YAML se compare facilement ligne à ligne, ce qui lui convient bien pour la gestion de versions. Validez le fichier converti par un commit et laissez vos collègues voir chaque changement comme une différence claire, ce qui était bien plus difficile avec une seule ligne de JSON minifié.
Attention aux secrets
Le JSON exporté depuis des outils inclut parfois des jetons et des mots de passe. Comme la conversion se fait dans votre navigateur, rien ne quitte votre appareil, mais le fichier YAML contiendra les mêmes secrets. Retirez-les, ou placez-les dans un endroit plus sûr, avant de valider le fichier par un commit ou de le partager.
Surveillez l'indentation en modifiant
Dès que vous modifiez à la main, le principal risque est une ligne décalée d'une espace. Utilisez un éditeur qui montre les espaces et vérifie le YAML pendant la frappe, et gardez la même largeur à chaque niveau, comme l'a fait le convertisseur.
Reconvertissez quand la source change
Si le JSON est produit par un programme et change de temps en temps, reconvertissez le JSON en YAML pour chaque nouvelle version et reportez vos commentaires de l'ancien fichier dans le nouveau. Un outil de comparaison en fait l'affaire de quelques minutes.
Confidentialité et manipulation
Pourquoi la conversion locale compte pour la configuration
Les fichiers de configuration contiennent souvent des adresses, des noms de systèmes internes et parfois des clés et des mots de passe. De nombreux convertisseurs en ligne envoient votre fichier vers un serveur, le traitent et renvoient le résultat, et pendant un temps une copie vit sur une machine que vous ne contrôlez pas. Ici, c'est votre propre navigateur qui fait le travail ; le fichier reste donc sur votre appareil.
Ce qui se passe quand vous partez
Quand vous fermez la page, le fichier converti disparaît du navigateur ; téléchargez-le donc d'abord. Rien de votre fichier n'est conservé.
Si quelque chose se passe mal
La page dit que le fichier n'est pas du JSON valide
Il peut y avoir une virgule égarée, un guillemet manquant ou un crochet qui ne se ferme pas. Ouvrez le fichier dans un éditeur qui signale les erreurs JSON et corrigez la ligne qu'il indique.
L'outil rejette le YAML
Vérifiez les noms de clés et les types qu'il attend. Le YAML est valide, mais l'outil peut vouloir d'autres noms ou une autre structure.
La page se fige avec un gros fichier
Tout s'exécute sur votre appareil, et un gros fichier demande de la mémoire. Réessayez sur un ordinateur, ou scindez les données.
Outils associés
La même famille d'outils couvre les tâches voisines. Pour revenir en arrière, utilisez Convertir un YAML en JSON. Pour le balisage, Convertir un JSON en XML et Convertir un XML en JSON convertissent entre ces deux formats. Pour les tableaux, il y a Convertir un JSON en CSV, Convertir un CSV en JSON, Convertir un JSON en XLSX et Convertir un XLSX en JSON.
Un exemple détaillé
Supposons qu'un outil imprime ses réglages dans un fichier JSON de 150 lignes, et que vous vouliez les garder dans votre dépôt comme une configuration que vos collègues peuvent lire et commenter. Vous déposez le fichier ici et appuyez sur le bouton. Un instant plus tard, vous téléchargez un YAML d'environ 90 lignes dans lequel la structure se lit comme un plan. Vous ajoutez un commentaire au-dessus de chaque section, le validez par un commit et dites à l'équipe où le modifier. Le JSON reste comme sortie de l'outil.
Une courte liste de contrôle
Avant de convertir
Vérifiez que le JSON est valide. Simplifiez l'imbrication profonde si vous le pouvez. Gardez le JSON.
Pendant la conversion
Restez sur la page jusqu'à ce que le fichier soit prêt.
Après la conversion
Ouvrez le YAML, vérifiez la structure et les types, ajoutez des commentaires et testez-le avec l'outil qui le lira.
Erreurs courantes
S'attendre à un fichier plus court
Une imbrication profonde fait une indentation profonde. Le YAML est plus lisible, pas toujours plus petit.
Modifier avec des tabulations
Le YAML n'autorise pas les tabulations pour l'indentation. Utilisez des espaces.
Perdre la source
Si le JSON vient d'un programme, gardez-le et régénérez le YAML quand il change.
Votre fichier reste sur votre appareil
La conversion se fait en local. Votre fichier est lu par votre propre navigateur, réécrit là et rendu sous forme de YAML. Rien n'est envoyé : aucune copie n'aboutit sur un serveur et personne d'autre ne peut le lire. Pour une configuration au contenu privé, c'est la manière sûre de convertir un JSON en YAML.
Résumé
Pour convertir un JSON en YAML ici, déposez le fichier et appuyez sur le bouton. Il est lu et écrit dans votre navigateur ; le fichier ne quitte donc jamais votre appareil. Tout est conservé, dans les deux sens : dictionnaires, listes, chaînes, nombres, booléens et null. Les structures répétées sont écrites en entier plutôt que sous forme d'ancres ; le fichier se lit donc tout droit, de haut en bas. Le YAML met du sens dans son indentation ; une valeur qui se retrouve profondément imbriquée donne donc un fichier profondément indenté, lisible mais pas court. Les longues chaînes sont coupées vers cent colonnes, ce qui change l'endroit où tombent les sauts de ligne sans changer la valeur. Les clés gardent leur ordre tel que le JSON l'avait.