Validateur et formateur YAML

Collez du YAML pour vérifier sa syntaxe, localiser les erreurs et obtenir une sortie propre et uniforme.

Options de sortie

YAMLentrée

Vide

YAMLsortie

La sortie YAML s'affiche ici

Fonctionne entièrement dans votre navigateur: rien n'est envoyé. Des limites d'usage raisonnable s'appliquent (5 MB par entrée, nombre de conversions limité) pour éviter le spam et les robots.

Charger depuis une URL

Le fichier est récupéré directement par votre navigateur : le serveur doit donc autoriser les requêtes cross-origin.

Raccourcis clavier

Ctrl / ⌘ + Enter Convertir maintenant
Ctrl / ⌘ + S Télécharger la sortie
Alt + Shift + C Copier la sortie
Alt + Shift + F Réparer et formater le JSON d'entrée
Alt + Shift + S Inverser le sens
Alt + Shift + T Basculer entre les vues code, arbre et correspondance
Ctrl / ⌘ + Z Annuler, y compris Formater, Réparer et Effacer
Esc Quitter le plein écran
Taille du texte de l'éditeur

Normaliser un YAML désordonné

Une indentation mixte, des maps en ligne et des guillemets inutiles s'analysent sans problème, mais sont difficiles à relire. La sortie formatée donne la même forme à chaque fichier.

Entrée
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
Formaté
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

Erreurs YAML courantes et comment les corriger

Voici les messages que vous verrez le plus souvent, dans ce validateur et dans des outils comme kubectl, Helm et docker compose.

Message d'erreurSignification et correction
tab characters must not be used in indentation YAML n'autorise que des espaces pour l'indentation. Remplacez chaque tabulation par des espaces.
bad indentation of a mapping entry Une clé n'est pas indentée comme ses voisines, ou une valeur simple contient ": ". Alignez la clé sur ses voisines, ou mettez la valeur entre guillemets.
mapping values are not allowed in this context Le même problème, tel que le signalent kubectl et Helm : généralement une valeur sans guillemets contenant ": ", comme une URL ou une heure. Mettez la valeur entre guillemets.
end of the stream or a document separator is expected Un élément de liste ou une clé se trouve au mauvais niveau d'indentation, par exemple une liste suivie d'un mapping au même niveau.
unexpected end of the stream within a flow collection Une liste en ligne [ … ] ou une map { … } n'est jamais fermée. Ajoutez le crochet ou l'accolade manquant.
duplicated mapping key La même clé apparaît deux fois dans un mapping. Supprimez ou renommez l'une d'elles.
unidentified alias Un alias comme *defaults est utilisé avant son ancre &defaults, ou sans elle.

Ce que vérifie le validateur

Cassez volontairement le fichier avec les boutons et regardez quelle vérification le détecte.

Syntaxe et indentation

Tabulations, clés mal alignées, guillemets et crochets non fermés sont signalés avec la ligne et la colonne exactes.

Clés en double

Une clé définie deux fois dans le même mapping est une erreur, là où certains analyseurs gardent la dernière valeur sans prévenir.

Ancres et alias

Chaque alias doit pointer vers une ancre définie plus haut dans le document, et les clés de fusion doivent référencer des mappings.

Plusieurs documents

Chaque document d'un fichier séparé par --- est analysé, et les notes indiquent combien ont été trouvés.

Privé par défaut

La validation s'exécute dans votre navigateur : les secrets des fichiers de CI et des manifestes ne quittent jamais votre machine.

Autres outils

Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.

Questions fréquentes

Comment valider du YAML en ligne ?

Collez votre YAML ou déposez un fichier .yaml ou .yml. Le badge affiche « YAML valide » ou « YAML invalide » pendant la saisie. Pour un fichier invalide, vous obtenez le message d'erreur avec la ligne et la colonne exactes, et la ligne est mise en évidence dans l'éditeur.

À quoi sert la sortie formatée ?

Elle réécrit les mêmes données avec une indentation et des guillemets cohérents : style bloc, l'indentation choisie et des guillemets seulement là où c'est nécessaire. C'est un moyen rapide de normaliser un fichier avant de le committer.

Les commentaires sont-ils conservés dans la sortie formatée ?

Non. Le validateur analyse le YAML en données puis le réécrit, et les commentaires ne font pas partie des données. Utilisez la sortie pour vérifier la structure, et gardez votre fichier d'origine si ses commentaires comptent.

Puis-je valider un fichier YAML multi-document ?

Oui. Les documents séparés par --- sont vérifiés un par un, et la sortie formatée les garde comme documents distincts. Les notes sous l'éditeur indiquent combien de documents ont été trouvés.

Vérifie-t-il les schémas Kubernetes ou Docker Compose ?

Il vérifie la syntaxe YAML, pas un schéma particulier. Un fichier peut être du YAML valide et être quand même rejeté par kubectl ou docker compose à cause d'un champ inconnu. Utilisez kubectl apply --dry-run=server ou docker compose config pour vérifier le schéma.

Quelle version de YAML est utilisée ?

L'analyse suit le schéma core de YAML 1.2 : yes, no, on et off restent donc des chaînes. Avec « Compatible YAML 1.1 » activé, la sortie met ces mots entre guillemets, pour que les analyseurs plus anciens comme PyYAML les lisent aussi comme des chaînes.