YAML Formatter & Validator
Understand YAML Formatter & Validator
Ce formateur réimprime le YAML avec une indentation cohérente et signale les structures qu'il ne sait pas lire.
How it works
YAML exprime l'imbrication par l'indentation plutôt que par des délimiteurs, si bien que l'analyseur suit le nombre d'espaces en début de chaque ligne et en déduit le mappage. Les valeurs sont ensuite typées d'après leur texte : true et false sont des booléens, null et ~ valent null, un nombre nu est un nombre, et tout le reste est une chaîne sauf s'il est entre guillemets. La sortie est resérialisée à partir des valeurs analysées, d'où son uniformité — et d'où la disparition de tout commentaire présent à l'origine.
When to use it
- Vérifier un workflow GitHub Actions ou un manifeste Kubernetes avant de le pousser.
- Trouver la ligne où un bloc collé s'est retrouvé au mauvais niveau d'indentation.
- Normaliser l'indentation d'un fichier de configuration que plusieurs personnes ont modifié.
- Confirmer qu'une valeur que vous vouliez textuelle n'est pas lue comme un nombre ou un booléen.
Watch out for
- Les tabulations ne sont jamais légales pour l'indentation en YAML. Une seule tabulation insérée par un éditeur est une erreur de syntaxe pour tout analyseur conforme, et elle est invisible — c'est la raison la plus fréquente de l'échec d'un manifeste.
- En YAML 1.1, toujours le comportement par défaut de PyYAML et de beaucoup d'outils plus anciens, les valeurs non citées yes, no, on et off sont des booléens, si bien qu'un champ pays valant NO devient false. C'est le problème de la Norvège. Cet outil suit YAML 1.2 et les traite comme des chaînes : mettez-les entre guillemets dans tous les cas et les deux s'accordent.
- Les commentaires ne sont pas préservés. Le reformatage restitue les données, pas le fichier : ne recollez donc pas le résultat par-dessus une configuration dont les commentaires vous sont nécessaires.
- L'outil gère la forme qu'ont la plupart des fichiers de configuration : clés de premier niveau, mappages imbriqués et listes simples. Les ancres et alias (&defaults, *defaults), les scalaires de bloc (| et >) et les fichiers multi-documents séparés par --- ne sont pas reproduits.
Not the right tool for: Valider un manifeste contre son schéma. La syntaxe peut être parfaite alors que chaque champ est faux ; c'est ce que vérifient kubeconform, actionlint ou le validateur de la plateforme elle-même.
Frequently Asked Questions
Pourquoi mon YAML est-il invalide ?
Erreurs YAML courantes : des tabulations au lieu d'espaces pour l'indentation (YAML exige des espaces), des niveaux d'indentation incohérents, des caractères spéciaux non entourés de guillemets (: { } [ ] , # & * ? | - < > = ! % @ `), et des valeurs particulières comme « yes » ou « no » interprétées de façon inattendue comme des booléens.
Comment inclure un deux-points dans une valeur YAML ?
Un deux-points suivi d'une espace ouvre une paire clé/valeur en YAML. Pour insérer un deux-points littéral dans une valeur, mettez toute la chaîne entre guillemets : message: "Error: connection failed", ou utilisez un scalaire de bloc (|) pour les valeurs multilignes.
Quelle version de YAML cet outil utilise-t-il ?
Ce formateur utilise YAML 1.2, plus strict que YAML 1.1. Contrairement à la 1.1, YAML 1.2 ne traite que true et false comme des booléens (pas yes/no/on/off), ce qui le rend entièrement compatible avec JSON.
How to Use YAML Formatter & Validator
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.