Aller au contenu principal
Bethemesh
Développement

Formateur YAML

Réindentez un document YAML, normalisez sa présentation et détectez les principales erreurs structurelles directement dans votre navigateur.

  • Presse-papiers
  • Export
Automatiser

Intégrer ce widget

Personnalisez le rendu, vérifiez l’aperçu puis copiez le code.

Aperçu

Type de code d’intégration

Code à copier

Responsive et redimensionné automatiquement par Bethemesh.

Cet outil vous a-t-il été utile ?

Comment fonctionne cet outil ?

Réindentez un document YAML pour relire sa structure sans le convertir en JSON. Le formateur analyse le document avant de le réécrire, ce qui permet de distinguer un mapping, une liste et un simple texte. Il conserve la représentation des commentaires, ancres et valeurs multilignes au lieu de reconstruire uniquement les valeurs finales. C’est utile pour une configuration versionnée ou un extrait à partager avec une équipe. Le fichier reste dans votre navigateur ; le traitement ne consulte ni dépôt distant ni service de déploiement.

Le parseur utilise YAML 1.2 par défaut et tient compte des directives de version qu’il prend en charge. Une fois le document reconnu, la sérialisation applique l’indentation choisie, avec un minimum de deux espaces. Les listes et mappings sont distingués syntaxiquement : les espaces ne sont pas simplement remplacés ligne par ligne, ce qui pourrait décaler le contenu d’une chaîne littérale.

Les clés répétées dans un même mapping sont refusées, tout comme une syntaxe invalide ou plusieurs documents dans la même entrée. Les tabulations ne servent pas à indenter la structure YAML ; elles peuvent néanmoins appartenir à une valeur selon sa syntaxe. Un texte scalaire tel que not yaml est valide : YAML ne se limite pas aux paires clé/valeur.

La mise en page travaille sur le document YAML et ne développe pas les alias en objets JSON. Les ancres et commentaires peuvent donc rester représentés. Les grands entiers conservent leur écriture sans passer par un nombre JavaScript arrondi. Les espaces de présentation, styles de citation ou espaces des collections compactes peuvent être normalisés ; la sortie n’est pas une copie octet pour octet de l’entrée.

Une réussite confirme que le parseur peut lire ce document, pas que votre application acceptera ses paramètres. L’outil ne charge pas les fichiers désignés par des chemins et n’interprète pas la signification métier des tags personnalisés. Un consommateur YAML plus ancien peut également appliquer d’autres règles de types : vérifiez la version attendue par votre environnement.

Comment utiliser cet outil ?

  1. Importer un seul document YAML

    Collez le texte complet, commentaires compris. Si le fichier comporte plusieurs sections documentaires séparées par ---, traitez chaque document séparément.

  2. Choisir l’indentation puis formater

    Sélectionnez la largeur proposée et lancez la mise en page. En cas de refus, recherchez un mapping mal fermé, une clé répétée ou une indentation structurelle invalide.

  3. Relire et récupérer le fichier

    Comparez les valeurs multilignes et commentaires avant de copier ou télécharger le YAML. Modifier l’entrée ou l’indentation masque le précédent résultat.

Cas d'utilisation

Relire une configuration avant un commit

Uniformisez l’indentation pour examiner les niveaux et commentaires. La présentation seule ne confirme ni les noms de paramètres ni leur validité dans le logiciel cible.

Conserver une configuration documentée

Préférez ce formateur à un aller-retour JSON lorsque les commentaires et noms d’ancres servent à comprendre le fichier.

Distinguer erreur de syntaxe et mauvais contrat

Vérifiez d’abord que le YAML est lisible, puis testez séparément les règles applicatives avec les outils de votre projet.

Exemples

Normaliser une indentation valide

Trois espaces constituent ici une indentation valide. Avec la largeur par défaut de deux espaces, child est réaligné et le commentaire note reste présent.

Entrée

# note
root:
   child: 1

Résultat

# note
root:
  child: 1

Garder une liste en notation compacte

Le parseur reconnaît items comme une liste et active comme un booléen. La notation compacte reste une liste ; seuls ses espaces de présentation sont normalisés.

Entrée

items: [a, b]
active: true

Résultat

items: [ a, b ]
active: true

Conseils et bonnes pratiques

  • Ne remplacez pas globalement les espaces dans un fichier YAML : ils peuvent faire partie d’un bloc de texte dont la valeur doit rester précise.
  • Écrivez entre guillemets les chaînes qui ressemblent à des dates ou booléens si plusieurs consommateurs YAML peuvent interpréter le même fichier différemment.
  • Pour obtenir du JSON, utilisez le convertisseur JSON/YAML : il applique des contrôles supplémentaires sur les valeurs représentables dans JSON.
  • Gardez les directives et commentaires utiles dans votre copie source et vérifiez le diff avant de remplacer une configuration partagée.

Sources et références

Questions fréquentes

Pourquoi un simple texte est-il accepté comme YAML ?

YAML autorise un scalaire à la racine. not yaml est une chaîne valide, même si une application précise exige un objet de configuration. La syntaxe du format et le contrat applicatif sont deux contrôles distincts.

Les commentaires et ancres disparaissent-ils au formatage ?

Le moteur conserve leur représentation dans le document YAML au lieu de passer par JSON. Leur mise en page peut évoluer, mais ils ne sont pas délibérément supprimés comme lors d’une conversion vers un format sans commentaires.

La validation garantit-elle une configuration Kubernetes correcte ?

Non. Le parseur vérifie le document YAML ; il ne connaît pas les ressources, versions API ou contraintes du cluster. Utilisez ensuite les validations prévues dans votre environnement Kubernetes.

Pourquoi les clés dupliquées sont-elles refusées ?

Deux occurrences d’un même nom peuvent produire des interprétations différentes selon le lecteur YAML. Le refus vous invite à choisir explicitement la valeur ou la structure attendue plutôt que d’en perdre une silencieusement.

Outils associés

Continuez avec ces outils

Des outils similaires ou complémentaires à celui-ci.

Outils similaires

Formateur JSON

Formatez, minifiez et validez un document JSON pour le rendre plus lisible ou plus compact.

DéveloppementMis en avantUtiliser l’outil