Formateur et Validateur YAML - Corriger l’indentation, trouver l’erreur
Formateur et validateur YAML
Ce que fait cet outil
YAML n’a pas d’accolades : c’est l’indentation qui porte la structure. Agréable à lire, donc, mais facile à casser — une espace égarée et une clé se retrouve sous le mauvais parent. Cet outil réindente le document à une largeur unique, vous dit où il est cassé et montre comment il est réellement lu.
Comment l’utiliser
- 1 Collez votre YAML dans la zone et choisissez la largeur d’indentation — deux espaces est le choix courant.
- 2 Appuyez sur Formater pour réindenter, ou sur Valider pour vérifier sans changer un seul caractère.
- 3 Pas sûr qu’une valeur soit lue comme vous le pensiez ? Appuyez sur Vers JSON et regardez.
Les tabulations ne sont pas de l’indentation
La spécification YAML interdit les tabulations dans l’indentation, et la plupart des analyseurs refusent le fichier d’emblée. Leur message aide rarement : la ligne incriminée est souvent celle qui suit le vrai problème. Cet outil nomme la ligne qui contient la tabulation.
Vos commentaires sont conservés
Beaucoup de formateurs analysent le document en arbre puis le réimpriment. C’est propre, et cela supprime tous vos commentaires — inutilisable pour un docker-compose ou un pipeline CI. Celui-ci ne réécrit que l’espace de tête : commentaires, ordre des clés et style de guillemets restent exactement tels quels.
Pourquoi NO est devenu false
En YAML 1.1, les mots nus yes, no, on et off étaient des booléens. Une liste de pays contenant le code NO pour la Norvège se chargeait donc en false — un bug assez célèbre pour avoir un nom. YAML 1.2 a supprimé cette règle, et cet outil suit la 1.2 : seuls true, false et null sont des mots-clés. Si vous voulez un booléen, écrivez true ou false ; si vous voulez le texte, vous l’avez déjà.
Ancres, alias et scalaires en bloc
Une ancre (&nom) marque un nœud pour qu’un alias (*nom) puisse le réutiliser plus loin — pratique pour des définitions de services répétées. Les scalaires en bloc (| et >) portent du texte multiligne : la barre verticale garde vos retours à la ligne, le chevron les replie en espaces. Les trois sont compris ici, et l’indentation à l’intérieur d’un scalaire en bloc est traitée comme une donnée, pas comme de la mise en forme.