Formateur YAML

Oui. Le formateur analyse votre document avec un analyseur qui conserve un arbre syntaxique concret : les commentaires sur leur propre ligne, ceux qui suivent une valeur et les blocs de commentaires entre sections ressortent là où ils étaient. Si vous activez le tri des clés, chaque commentaire reste attaché à la clé qu’il surplombe. La plupart des formateurs en ligne transforment le YAML en données brutes puis les réimpriment, ce qui fait disparaître tous les commentaires ; le convertisseur JSON de ce site fait de même, inévitablement, et vous indique combien ont été supprimés.

La structure et le texte ne sont pas touchés : les guillemets restent exactement tels que vous les avez écrits, les ancres, alias et clés de fusion restent en place, les scalaires de bloc gardent leur contenu et l’ordre des clés est conservé sauf si vous demandez un tri. Deux choses sont normalisées. Les nombres sans guillemets sont imprimés sous forme canonique en YAML 1.2, donc 022 devient 22, +1 devient 1 et 1e3 devient 1e+3 ; passez la version en 1.1 et les octaux à zéro initial comme 0644 sont conservés. Les scalaires repliés (>) sont remis en forme en conservant les sauts de paragraphe. Si une valeur doit garder son écriture exacte, mettez-la entre guillemets : les avertissements sous la sortie listent chaque valeur sans guillemets que YAML 1.1 et 1.2 lisent différemment.

Deux espaces par défaut, ou quatre si vous le choisissez. Chaque niveau du document reçoit la même largeur quelle que soit l’indentation d’origine, et une séquence imbriquée sous une clé est indentée sous cette clé. YAML interdit les tabulations pour l’indentation, il n’y a donc pas d’option tabulation, et un document indenté avec des tabulations est signalé comme une erreur avec son numéro de ligne au lieu d’être reformaté.

Oui. L’option Trier les clés classe alphabétiquement les clés de chaque mapping, à tous les niveaux d’imbrication, ce qui facilite les diffs et la revue de code pour les fichiers modifiés par plusieurs personnes ou outils. Les séquences gardent leur ordre, parce que dans une liste l’ordre a un sens. Les commentaires suivent la clé à laquelle ils appartiennent. Le tri est désactivé par défaut : l’ordre des clés n’a aucun sens en YAML, mais il en a souvent pour les personnes qui lisent le fichier.

Oui. Un fichier contenant plusieurs documents séparés par --- est reformaté document par document et les séparateurs sont conservés ; un manifeste Kubernetes avec un Deployment, un Service et un Ingress reste un seul fichier. Un --- initial et une directive %YAML sont conservés aussi, et la ligne d’état indique combien de documents ont été reformatés.

Le formateur utilise un analyseur plus strict que le convertisseur, parce qu’il doit comprendre la forme exacte du document pour le reconstruire avec les commentaires en place. Un document que le convertisseur accepte mais qui échoue ici est signalé avec la ligne, une explication en langage clair et une correction suggérée, comme dans le validateur YAML. Le guide des erreurs YAML courantes passe en revue les six fautes derrière presque tous les échecs d’analyse.

Non, et ils se complètent bien. yamllint signale les problèmes de style et de syntaxe mais ne réécrit pas le fichier ; ce formateur réécrit l’indentation et les espaces mais n’impose pas de règles comme la longueur de ligne. La sortie YAML de Prettier est proche de ce que vous obtenez ici, et si votre projet l’exécute déjà, cette page est inutile : elle existe pour le fichier que vous avez dans le presse-papiers à l’instant, sans rien installer ni rien envoyer.

Non. Le formateur est du JavaScript qui s’exécute dans l’onglet de votre navigateur. La bibliothèque yaml se charge avec la page et il n’existe aucun point de terminaison auquel envoyer un document ; vous pouvez charger la page, vous déconnecter et continuer à formater. Cela compte pour les fichiers qu’on veut généralement remettre au propre : manifestes Kubernetes, fichiers Docker Compose et pipelines CI contiennent des noms d’hôte, des registres et parfois un secret.

yq -i . config.yaml reformate un fichier sur place en conservant les commentaires ; sans -i, le résultat est affiché. Avec Prettier installé, npx prettier --write "**/*.{yml,yaml}" formate tous les fichiers YAML d’un projet. En Python, ruamel.yaml en mode round-trip reformate en conservant les commentaires, ce que PyYAML ne sait pas faire. Pour un fichier isolé, collez-le dans le formateur ci-dessus.