Aller au contenu

Formateur YAML

Validez et reformatez YAML avec indication claire des erreurs de ligne et de colonne.

Entrée
Sortie

Formateur YAML

YAML s'affiche partout : des manifestes Kubernetes aux flux de travail GitHub Actions en passant par les fichiers de configuration d'applications. Il est impitoyable avec les espaces blancs : un seul espace mal aligné détruit tout le document. Cet outil vérifie la syntaxe d'un document YAML et le reformate de manière cohérente, afin que vous puissiez intercepter un pipeline ou un fichier de configuration défectueux avant son exécution.

Collez un document et il est analysé instantanément. Les données valides sont renvoyées reformatées avec la largeur d'indentation de votre choix ; les données invalides renvoient la ligne et la colonne exactes du problème ainsi que ce que l'analyseur attendait, vous n'aurez pas à deviner laquelle des quarante lignes contient la tabulation perdue. Deux vérifications s'exécutent automatiquement sur chaque document valide : un avertissement si une ligne utilise une tabulation pour l'indentation (la spécification YAML l'interdit bien que de nombreux éditeurs l'insèrent par défaut) et un décompte des clés en double dans le même mappage (YAML l'autorise, mais cela signifie généralement que seule la dernière reste et les autres sont du poids mort).

Les options contrôlent à la fois la forme et les espaces blancs. Triez les clés par ordre alphabétique pour obtenir un document déterministe et comparable, utile lorsqu'une configuration générée produit continuellement des diffs git bruyants sans raison fonctionnelle. Réduire les listes courtes transforme une séquence scalaire comme une liste d'étiquettes sur trois lignes en une seule ligne de style flux comme tags: [a, b, c] ; laissez-la désactivée et toutes les listes de flux en ligne dans l'entrée seront étendues à un élément par ligne, ce qui est généralement plus facile à vérifier et fusionner. Supprimer les commentaires supprime les commentaires de ligne complète et les commentaires hash finaux pour une version minifiée, tandis que les conserver préserve vos commentaires de document exactement tels qu'ils sont écrits.

Le formatage se déroule entièrement dans votre navigateur. Le YAML que vous collez n'est jamais chargé, enregistré ni envoyé nulle part : il est analysé, reformaté et affiché localement, puis disparaît lorsque vous fermez ou rechargez l'onglet.

FAQ

Mon YAML est-il chargé quelque part?
Non. L'analyse et le formatage se déroulent entièrement dans le moteur JavaScript de votre navigateur. Rien de ce que vous collez n'est envoyé à un serveur, enregistré ou stocké en dehors de votre appareil.
Que signifient la ligne et la colonne dans l'erreur?
Ils pointent vers l'endroit exact de votre document où l'analyseur a cessé de comprendre, en comptant à partir du haut et de la gauche du texte que vous avez collé. Il indique également ce qu'il attendait, comme une indentation cohérente ou une valeur après un deux-points.
Pourquoi avertit-il des tabulations?
La spécification YAML interdit d'utiliser des caractères de tabulation pour l'indentation : seuls les espaces sont autorisés. Un document avec indentation par tabulation peut être analysé de manière incohérente ou échouer complètement dans une autre implémentation YAML, c'est pourquoi l'outil le signale même si votre entrée s'analyse toujours ici.
Que se passe-t-il avec les clés dupliquées?
YAML permet de répéter une clé dans le même mappage, et la plupart des analyseurs conservent silencieusement uniquement la dernière valeur. L'outil ne le rejette pas, mais compte les doublons et marque la ligne affectée afin que vous puissiez décider si c'était intentionnel.
Peut-il corriger le YAML invalide pour moi?
Non : il vous indique exactement où l'analyse a échoué afin que vous puissiez réparer la source. Deviner automatiquement une correction pour une indentation cassée risquerait de changer le sens du document.