Aide

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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 :

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.

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.

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 :

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

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.