Comment convertir un JSON en YAML

À quoi sert la conversion JSON vers YAML ?

Cet outil sert à transformer un texte JSON valide en texte YAML, notamment lorsque vous devez relire une configuration, préparer un fichier pour un autre système ou présenter des données imbriquées dans un format plus lisible. Il prend en charge les objets, les objets imbriqués et les tableaux. Le résultat est présenté en YAML à blocs, avec des marqueurs de liste pour les tableaux non vides et, si nécessaire, des guillemets autour de chaînes dont le contenu a une signification particulière en YAML.

Convertir un JSON en YAML

1. Préparez le contenu à convertir sous forme de texte JSON. Vérifiez la présence des guillemets, des deux-points, des virgules et des accolades ou crochets correspondants.

2. Collez ce texte dans la zone d’entrée. Cette saisie est facultative : si elle reste vide ou ne contient que des espaces, la conversion peut réussir et produire un texte YAML vide.

3. Ajustez les options si nécessaire. Vous pouvez choisir un nombre d’espaces pour l’indentation ; la valeur par défaut est de 2. Vous pouvez aussi activer le tri des clés des objets, désactivé par défaut. Le tri peut faciliter la comparaison de plusieurs résultats, tandis que l’ordre d’origine convient mieux lorsque vous souhaitez conserver la présentation des clés.

4. Lancez la conversion, puis consultez le texte obtenu. Pour un JSON valide, vérifiez la structure des objets imbriqués et des tableaux dans le résultat. Si le contenu d’entrée n’est pas un JSON valide, la conversion échoue et aucun texte YAML n’est produit.

Comprendre le résultat

Un résultat réussi correspond à du texte YAML, ou à un texte vide lorsque l’entrée est vide ou composée uniquement d’espaces. Les objets imbriqués apparaissent sous forme de blocs indentés et les tableaux non vides utilisent des marqueurs de liste. La conversion ne signifie pas que le contenu a été vérifié selon un schéma métier, ni que chaque détail de mise en forme du JSON d’origine a été conservé.

Si le résultat indique un échec, commencez par contrôler la validité syntaxique du JSON fourni. Une erreur peut aussi survenir pendant la production du YAML ; dans ce cas, le résultat est également traité comme une conversion échouée, et non comme une réussite partielle.

Exemple pratique

Vous préparez une petite configuration de service et souhaitez la relire dans une structure YAML plus lisible.

Collez ce JSON : {"service":"api","ports":[80,443]}. Conservez l’indentation par défaut, lancez la conversion et examinez le texte produit.

La sortie réussie prend une forme YAML à blocs : les propriétés restent organisées en mappings et le tableau non vide est présenté avec des marqueurs de liste.

Limites

• La conversion ne vérifie pas le contenu selon un schéma métier et les faits disponibles ne garantissent pas la conservation de chaque détail de mise en forme du JSON original.

Erreurs fréquentes

• Une virgule finale, une clé non entourée de guillemets ou des guillemets mal fermés rendent le JSON invalide. Corrigez la syntaxe, puis relancez la conversion.

Questions fréquentes

Les objets imbriqués et les tableaux JSON sont-ils convertis ?

Oui, les objets imbriqués et les tableaux sont pris en charge lorsqu’ils se trouvent dans un JSON valide. Les tableaux non vides apparaissent avec des marqueurs de liste dans le YAML produit.

Que se passe-t-il si je ne fournis aucun JSON ?

Oui. Si l’entrée est vide ou composée uniquement d’espaces, la conversion réussit avec un texte YAML vide. Cette exception concerne uniquement cette saisie vide ; un texte qui n’est pas un JSON valide entraîne un échec.

Puis-je modifier l’indentation et l’ordre des clés ?

Vous pouvez définir une indentation numérique différente de la valeur par défaut de 2 et activer le tri des clés. Le tri est désactivé par défaut.