Convertir JSON en YAML
Des fichiers de config propres, guillemets sûrs

Ce que fait cet outil pour convertir JSON en YAML

Ce convertisseur JSON en YAML prend n’importe quel document JSON et écrit les mêmes données en YAML. Les objets deviennent des clés indentées, les tableaux des listes à tirets, et le texte long devient un bloc lisible. Votre navigateur fait la conversion, donc les données restent chez vous.

Beaucoup d’outils attendent du YAML plutôt que du JSON. Docker Compose, GitHub Actions, Kubernetes, Ansible et d’innombrables configurations l’utilisent. Pendant ce temps, les API et le code vous donnent surtout du JSON. C’est pourquoi cette étape revient chaque fois que des réglages passent d’un programme à un fichier de configuration.

Écrire du YAML à la main semble facile, pourtant certaines valeurs changent de sens en silence si personne ne les met entre guillemets. Le convertisseur sait lesquelles et met des guillemets exactement à celles-là, donc le YAML se relit comme les mêmes données.

Des accolades à l’indentation

JSON marque la structure avec des accolades et des crochets. YAML utilise l’indentation à la place. Chaque objet imbriqué se décale de deux espaces vers la droite, et chaque élément de tableau commence sur sa propre ligne avec un tiret. Les objets et listes vides restent courts, écrits {} et [].

Vous choisissez l’indentation : deux espaces, comme la plupart des projets, ou quatre pour les équipes qui aiment plus d’air. La liste ne propose pas de tabulations, car YAML les interdit pour l’indentation.

Convertir JSON en YAML avec des guillemets sûrs

Certaines chaînes ressemblent à d’autres types pour un lecteur YAML. Le texte NO peut devenir false, 1.10 le nombre 1.1, et 2024-01-01 un objet date. De même, une valeur qui commence par un dièse ou un astérisque a un sens spécial.

Le convertisseur vérifie chaque chaîne selon ces règles, y compris les anciennes que suivent encore des outils comme PyYAML. Tout ce qui est à risque reçoit des guillemets doubles, tandis que le texte ordinaire reste simple et lisible. Ainsi, le YAML veut dire exactement ce que voulait dire votre JSON.

Des blocs lisibles pour le texte long

Une chaîne JSON pleine d’échappements est difficile à lire. Le convertisseur écrit donc ce texte comme un bloc littéral qui commence par une barre verticale, et chaque ligne réapparaît sur sa propre ligne. Scripts, certificats et SQL dans une configuration se lisent alors d’un coup d’œil.

Le bloc garde le dernier retour à la ligne tel quel. Une chaîne sans retour final reçoit |-, et une chaîne avec des retours en trop à la fin reçoit |+, donc rien n’est ajouté ni perdu.

Nombres, clés et null

Les nombres gardent exactement le texte qu’ils ont dans le JSON, donc un identifiant de 20 chiffres les garde tous. Les booléens et les null deviennent true, false et null. Les clés restent sans guillemets autant que possible, et une clé comme y, n ou yes en reçoit, car les anciens lecteurs traitent aussi ces mots comme des booléens.

L’ordre des clés ne change jamais. Le YAML liste les clés dans le même ordre que le JSON, ce qui garde un diff ultérieur petit et facile à relire.

Les listes imbriquées fonctionnent de la même façon. Une liste dans une liste reçoit un tiret à chaque niveau, et un objet dans une liste commence sur la même ligne que son tiret. C’est la disposition que recommandent la plupart des guides de style YAML, donc le fichier paraît familier à qui l’ouvre.

Pourquoi le style bloc et pas le style en ligne

YAML peut aussi s’écrire en style en ligne, qui ressemble presque à du JSON avec accolades et crochets. Le convertisseur utilise cependant le style bloc, car c’est ce qu’on s’attend à lire dans un fichier de configuration. Chaque réglage a sa propre ligne, donc une modification touche une seule ligne et la relecture reste courte.

Les objets et listes vides sont la seule exception. Les écrire {} et [] est plus court et plus clair qu’un bloc vide, et tout lecteur YAML comprend les deux.

Avant de committer le YAML

Lisez le résultat une fois de haut en bas. L’indentation montre la structure d’un coup d’œil, donc un réglage dans la mauvaise section saute vite aux yeux. Ensuite, ajoutez des commentaires là où une valeur a besoin d’une raison, car JSON ne pouvait pas en porter.

Enfin, laissez l’outil propriétaire du fichier le vérifier. Par exemple, lancez un dry run pour Kubernetes ou une vérification de configuration pour Docker Compose. Le convertisseur garantit un YAML valide, tandis que ces outils savent si chaque réglage a du sens.

Quand le JSON contient une erreur

Avant d’écrire quoi que ce soit, le convertisseur lit le JSON strictement. Une virgule finale, un commentaire ou un guillemet simple l’arrête avec la ligne et la colonne exactes. Puis Montrer l’endroit place le curseur au bon endroit.

JSON en YAML en ligne pour le travail de configuration

Un cas courant est un workflow. Vous concevez des réglages dans le code, les exportez en JSON, puis il vous faut un fichier qui suit la syntaxe des workflows GitHub Actions. Un autre est Kubernetes, où une ressource obtenue en JSON doit retourner dans un dépôt en YAML.

La sortie suit la spécification YAML 1.2, donc tout lecteur moderne l’accepte. Vous voulez vérifier l’aller-retour ? Collez le résultat dans notre convertisseur YAML en JSON et comparez.