Formateur et validateur YAML

À quoi ça sert

YAML est très utilisé pour les fichiers de configuration — manifestes Kubernetes, workflows GitHub Actions et GitLab CI, Docker Compose, playbooks Ansible, documents OpenAPI — parce qu’il est facile à lire. Il est aussi facile à casser : une mauvaise indentation, une tabulation, un guillemet non fermé ou une espace manquante après les deux-points peuvent changer le sens d’un fichier ou l’empêcher de se charger.

Ce validateur analyse votre YAML et signale chaque erreur de syntaxe avec sa ligne et sa colonne, ainsi que des avertissements comme les directives inconnues. Quand le YAML est valide, il affiche le nombre de documents et le type de chaque valeur racine, et peut produire une copie reformatée avec une indentation homogène.

Mode d’emploi

1. Collez du YAML dans l’entrée, importez un fichier .yaml ou .yml, ou cliquez sur Exemple.
2. Le résultat s’affiche pendant la saisie : un badge vert YAML valide, ou une liste d’erreurs comme Ligne 3, colonne 2.
3. Laissez Afficher le YAML formaté activé pour obtenir une copie propre, avec 2 ou 4 espaces d’indentation. Copiez-la avec le bouton au-dessus du bloc.
4. Ne désactivez Clés en double = erreur que si vos outils acceptent les clés répétées.

Erreurs fréquentes

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• Indentation incohérente : les éléments d’un même niveau doivent commencer à la même colonne. YAML n’autorise pas les tabulations pour l’indentation.
• Espace manquante après les deux-points : key:value est une simple chaîne, pas une clé et une valeur.
• Caractères spéciaux sans guillemets : les valeurs qui commencent par *, &, !, %, @ ou un accent grave, ou qui contiennent : ou #, doivent être entre guillemets.
• Types inattendus : yes, no, on et off sont des chaînes en YAML 1.2 mais des booléens pour les anciens analyseurs YAML 1.1 ; mettez-les entre guillemets par prudence. Un numéro de version comme 1.10 devient le nombre 1.1 sans guillemets.

Valider la structure

Cet outil vérifie la syntaxe : le texte est-il du YAML bien formé ? Pour vérifier qu’un fichier contient les bonnes clés et les bons types, convertissez-le avec l’outil YAML vers JSON puis validez le résultat avec le Validateur JSON Schema.