Validateur YAML : vérifiez votre YAML pendant la saisie
Collez votre YAML : ce validateur YAML le vérifie pendant que vous tapez, puis explique chaque problème de syntaxe en termes simples, avec la ligne et la colonne. Il repère l'indentation par tabulation, les clés en double, les guillemets et crochets non fermés, ainsi que les espaces insécables invisibles qui ressemblent à une indentation sans en être une. Votre YAML est vérifié dans votre navigateur et n'est jamais envoyé.
Vérifier YAML en ligne : mode d'emploi
Collez ou tapez votre YAML dans la zone YAML. Il n'y a pas de bouton de validation : le texte est vérifié en direct.
- Un texte collé est vérifié aussitôt. Quand vous tapez, la vérification se lance environ un quart de seconde après votre dernière touche, un peu plus tard pour un très grand texte. Le résultat précédent reste estompé jusqu'à l'arrivée du nouveau.
- Lisez l'encadré sous l'éditeur. Un encadré vert YAML valide signifie que la syntaxe est correcte. Un encadré rouge YAML invalide (ou « YAML invalide : N problèmes ») énumère ce qui ne va pas.
- Chaque problème donne une phrase, « Ligne N, colonne M » et un extrait de la ligne avec ses numéros de ligne : deux lignes au-dessus, une en dessous et un ^ sous la colonne.
- Appuyez sur Afficher dans l'éditeur pour sélectionner cette ligne dans la zone, corrigez-la et regardez l'encadré passer au vert.
Seule la première erreur de syntaxe de chaque document est signalée. Les suivantes sont souvent des effets secondaires, par exemple un guillemet manquant qui avale les lignes suivantes. Les clés en double et les alias non définis sont toujours tous listés, et jusqu'à 20 problèmes sont affichés.
Vérifier la syntaxe YAML : les problèmes courants et leur correction
Chaque problème est expliqué par une phrase plutôt que par un message brut de l'analyseur. Voici les plus fréquents :
- La ligne est indentée avec une tabulation. Un éditeur a inséré une tabulation, ou elle est venue avec le collage. Remplacez la tabulation par des espaces.
- La ligne n'est pas alignée avec les autres clés de son mappage. Une clé a un espace de plus ou de moins que ses voisines. Donnez la même indentation aux clés d'un même niveau.
- L'indentation est incorrecte. Un bloc imbriqué n'est pas plus indenté que son parent. Indentez l'enfant davantage que la clé parente.
- Une clé apparaît plusieurs fois dans le même mappage. Un bloc copié a souvent laissé une clé répétée. Fusionnez ou supprimez le doublon.
- La ligne n'est pas une paire clé: valeur. Les deux-points manquent, ou une ligne coupée n'est pas indentée. Ajoutez
:après la clé, ou indentez la suite. - Une paire est écrite dans une autre sur la même ligne. La cause est souvent un second deux-points dans une valeur simple, comme dans
a: b: c. Mettez la valeur entre guillemets ou passez à une nouvelle ligne indentée. - Un crochet n'est jamais fermé, ou un guillemet ne se termine pas. Le message pointe la ligne où il a été ouvert. Ajoutez le caractère fermant.
- Une virgule manque entre des éléments dans
[ ]ou{ }. Deux éléments se touchent. Ajoutez la virgule. - Une valeur commence par
@ou par un accent grave. Mettez-la entre guillemets. - Un
#est collé au mot qui le précède. Il ne débute un commentaire que s'il est précédé d'un espace. Ajoutez l'espace ou mettez le texte entre guillemets. \qn'est pas une séquence d'échappement valide entre guillemets doubles. Cela arrive avec les chemins Windows. Écrivez\\ou utilisez des apostrophes.- Un alias renvoie à une ancre qui n'est pas définie plus haut. Définissez
&nomplus tôt dans le fichier. - Cette partie n'a pas sa place ici. Souvent, une liste avec
-est mélangée à des lignesclé: valeurau même niveau, ou la ligne du dessus est inachevée. Placez la liste sous sa propre clé et vérifiez la ligne du dessus. - Une directive
%en tête du document est invalide ou non prise en charge. Supprimez-la ou utilisez correctement%YAMLou%TAG.
Ce que signifient les messages d'autres analyseurs
Vous arrivez d'un message dans votre terminal ou dans un journal de CI ? Voici comment les formulations courantes correspondent à ce que signale ce validateur. Collez le même fichier et il vous montre la ligne.
found character that cannot start any token while scanning for the next token: une tabulation en début de ligne, ou une valeur qui commence par@ou par un accent grave.tabs are not allowed for indent: une tabulation utilisée comme indentation.mapping values are not allowed here: un second deux-points sur une ligne, commea: b: c, une valeur sans guillemets qui contient:, ou une ligne indentée sous une clé qui a déjà une valeur.did not find expected key: une ligne qui n'est pas alignée avec les autres clés de son mappage.bad indentation of a mapping entry: une clé indentée à la mauvaise profondeur.could not find expected ':': une ligne sans deux-points après la clé.
Les formulations varient selon l'analyseur (PyYAML, js-yaml, Ruby, Go, les chargeurs de Home Assistant et d'ESPHome), et un analyseur signale souvent une ligne située sous la vraie faute. Ce validateur désigne la ligne qu'il peut vous montrer.
Tabulations et caractères invisibles
Les deux fautes YAML les plus difficiles à repérer sont celles qu'on ne voit pas. Ce validateur les rend visibles.
- Une tabulation dans l'extrait est dessinée comme une flèche, et une espace insécable ou de largeur nulle comme un point.
- Si la ligne fautive contient un caractère invisible, une ligne supplémentaire le nomme avec son point de code, par exemple
U+00A0, et sa colonne. Sont couverts les espaces insécables, les caractères de largeur nulle, une marque d'ordre des octets et les espaces pleine chasse. - Quand le fichier est valide mais qu'une ligne commence par une espace invisible, un encadré jaune Valide, mais vérifiez cette ligne apparaît sous le vert. YAML lit ce caractère comme une partie de la clé : la ligne n'est donc pas vraiment indentée. Un texte copié depuis une page web, un wiki ou une application de messagerie en est la source habituelle.
Exemple : dans un fichier avec server: puis port: 8080, la dernière ligne, host: example.com, commence par deux espaces insécables au lieu de deux espaces. YAML la lit comme une clé distincte de premier niveau, et host n'est pas un enfant de server. L'encadré jaune nomme le caractère et la ligne.
Formater YAML et copier le résultat
Activez l'interrupteur Formater le YAML au-dessus de la zone. Il est désactivé par défaut. Quand le texte est valide, un bloc YAML formaté apparaît, avec un bouton Copier au-dessus qui devient Copié après la copie. Le formatage est prévisible :
- L'indentation est de 2 espaces. Il n'y a pas d'autre largeur, et les listes sous une clé sont indentées.
- Les commentaires, ancres, alias, styles de guillemets et l'ordre des clés sont conservés.
- Les lignes longues ne sont jamais coupées.
- Plusieurs documents gardent leurs séparateurs
---.
Seul un YAML valide peut être formaté : il ne répare donc pas un fichier cassé, corrigez d'abord les problèmes. Une sortie très longue est affichée tronquée après 600 000 caractères, et Copier la copie quand même en entier.
Valider un fichier YAML : usages, taille et limites
La vérification est la même quel que soit l'usage du YAML. Elle convient aux workflows GitHub Actions, à docker-compose.yml, aux manifestes Kubernetes et aux valeurs Helm, aux fichiers OpenAPI, aux playbooks Ansible, à la configuration de Home Assistant, aux modèles CloudFormation et à la configuration de mkdocs. Collez le fichier avant de valider votre commit et les problèmes de syntaxe apparaissent sans attendre une exécution de CI. Un fichier de plusieurs documents séparés par --- est vérifié document par document, et l'encadré vert indique combien il en a trouvé. Les ancres (&nom) et les alias (*nom) sont vérifiés. Les étiquettes personnalisées comme !Ref, !Sub et !GetAtt de CloudFormation, ou !reference de GitLab, sont acceptées comme valides.
La vérification s'exécute dans un Web Worker de votre navigateur. Les fichiers de configuration, de CI et Kubernetes habituels sont vérifiés en un clin d'œil. La limite est de 5 000 000 de caractères, et un texte proche de cette limite prend quelques secondes et beaucoup de mémoire. Au-delà, on vous demande de coller un extrait plus petit.
Seule la syntaxe YAML est vérifiée. Le validateur ne sait pas ce qu'attend un outil donné : les champs Kubernetes, les clés de GitHub Actions ou de Docker Compose et les règles de schéma JSON ne sont pas contrôlés, et un nom de clé mal orthographié passe quand même. Il suit YAML 1.2 : les mots yes, no, on et off de YAML 1.1 sont du texte ordinaire et ne sont jamais jugés. Il n'exécute, ne récupère et ne charge rien, et un ancien retour chariot Mac isolé n'est pas traité comme un saut de ligne.
Vous travaillez avec d'autres formats ? Remettez en forme et vérifiez du JSON avec le Formateur JSON, contrôlez-le par rapport à un schéma avec le Validateur de schéma JSON, ou vérifiez du balisage avec le Validateur XML. Vous cherchez un motif dans votre configuration ? Essayez-le dans le Testeur de regex.
Questions fréquentes
Comment valider un fichier YAML en ligne ?
Collez votre YAML dans la zone « YAML ». Le texte est vérifié pendant que vous collez ou tapez, il n'y a donc aucun bouton à presser. Un encadré vert « YAML valide » signifie que la syntaxe est correcte. Un encadré rouge « YAML invalide » donne chaque problème en termes simples, avec « Ligne N, colonne M » et un extrait de la ligne.
Pourquoi YAML indique-t-il que les tabulations ne sont pas autorisées pour l'indentation ?
YAML n'autorise que des espaces pour l'indentation, et une tabulation en début de ligne est une erreur de syntaxe. Les éditeurs insèrent souvent des tabulations quand vous appuyez sur la touche Tab, ou elles viennent avec un texte collé. Le validateur signale que la ligne est indentée avec une tabulation. Remplacez-la par des espaces.
Que signifie « mapping values are not allowed here » en YAML ?
Il y a généralement un second deux-points sur une ligne, comme dans « a: b: c », ou une valeur sans guillemets qui contient un deux-points. Il peut aussi s'agir d'une ligne indentée sous une clé qui a déjà une valeur. Mettez la valeur entre guillemets ou écrivez la paire intérieure sur sa propre ligne indentée.
Que signifie « did not find expected key » en YAML ?
Une ligne n'est pas alignée avec les autres clés de son mappage. Le plus souvent, une clé a un espace de plus ou de moins que ses voisines. Donnez la même indentation à toutes les clés d'un même niveau. Le validateur l'indique en précisant que la ligne n'est pas alignée avec les autres clés.
Comment trouver les clés en double dans un YAML ?
Collez le texte. Les clés en double d'un même mappage sont toujours toutes listées, chacune avec sa ligne et sa colonne. Un bloc copié a souvent laissé une clé répétée. Fusionnez les entrées ou supprimez le doublon.
Pourquoi un fichier valide affiche-t-il « Valide, mais vérifiez cette ligne » ?
Une ligne commence par une espace invisible, par exemple une espace insécable. YAML la lit comme une partie de la clé : la ligne n'est donc pas vraiment indentée, même si le fichier est valide. L'encadré jaune nomme le caractère et la ligne. Supprimez-le et saisissez des espaces ordinaires.
Puis-je valider un fichier GitHub Actions, Docker Compose ou Kubernetes ici ?
Oui, la vérification de syntaxe est la même pour tout YAML. Elle convient aux workflows, à docker-compose.yml, aux manifestes Kubernetes et à bien d'autres fichiers. Seule la syntaxe est vérifiée : le validateur ne sait pas quelles clés attend chaque outil, et un nom de clé mal orthographié passe quand même.
Quelle taille de fichier YAML puis-je vérifier ?
La limite est de 5 000 000 de caractères. Les fichiers de configuration habituels sont vérifiés en un clin d'œil, et un texte proche de la limite prend quelques secondes et beaucoup de mémoire. Au-delà, on vous demande de coller un extrait plus petit.
Recommandés
-
Yubico Security Key C NFCProtégez le compte GitHub ou cloud vers lequel vous poussez cette configuration.
-
Elgato Stream Deck Neo (8 touches)Une touche pour lancer vos commandes de lint, de commit et de déploiement.
-
Barres lumineuses connectées GoveeUne lumière douce derrière l'écran pour corriger la pipeline tard le soir.
Aide à garder les outils gratuits. ✨
Images non contractuelles. En tant que Partenaire Amazon, je réalise un bénéfice sur les achats remplissant les conditions requises.