Formateur YAML

Le formatage s'exécute dans ce navigateur. Votre YAML n'est envoyé à aucun serveur.

Collez du YAML avec au maximum 1 000 000 de caractères et 100 documents. Le formatage s'effectue dans ce navigateur.

YAML est tolérant sur la syntaxe et impitoyable sur l’indentation. Un seul espace de travers peut transformer en silence une clé en élément de liste, et une indentation hétérogène rend les revues pénibles. Ce formateur analyse votre entrée avec le moteur js-yaml (schéma core YAML 1.2) directement dans votre navigateur, puis la réémet avec l’indentation, le style de collections, les guillemets, l’ordre des clés et la largeur de ligne de votre choix, pour que vos configs donnent des diffs propres dans le gestionnaire de versions et restent lisibles pour tous les contributeurs.

Comment formater du YAML

  1. 1

    Collez votre YAML

    Jusqu'à 1 000 000 de caractères et jusqu'à 100 documents dans un même flux. Rien n'est envoyé : l'analyse s'exécute dans votre navigateur.

  2. 2

    Choisissez les options

    Largeur d'indentation, style bloc ou flux, guillemets, tri des clés et largeur de ligne.

  3. 3

    Formatez

    L'outil reconstruit chaque document avec un espacement canonique et le style choisi.

  4. 4

    Copiez et commitez

    La sortie est un YAML structurellement identique, prêt à être recollé dans votre config.

Avant et après

Entrée brouillonne :

server:
  port:   8080
  hosts: ["api.example.com",  "api2.example.com"]
  timeout:  30
  debug: true

Formaté (2 espaces, style bloc) :

server:
  port: 8080
  hosts:
    - api.example.com
    - api2.example.com
  timeout: 30
  debug: true

Options de formatage

Option Valeurs Par défaut
Largeur d’indentation 2, 4 2
Style de collections Bloc, flux Bloc
Guillemets Minimal, doubles, simples Minimal
Tri des clés Original, alphabétique Original
Largeur de ligne 80, 120, illimitée 120

Règles de guillemets

Le mode minimal est généralement ce que vous voulez : les chaînes restent sans guillemets, sauf si les laisser nues serait risqué. Le formateur ajoute automatiquement des guillemets pour :

  • Les booléens hérités écrits comme chaînes : yes, no, on, off, y, n. YAML 1.2 les lit déjà comme des chaînes, mais beaucoup de parseurs suivent encore YAML 1.1, où un no sans guillemets devient false. Le formateur les met toujours entre guillemets en sortie, si bien que le fameux bug de la Norvège (NO lu comme false dans une liste de pays) ne peut pas piéger celui qui consomme votre fichier.
  • Les nombres écrits comme chaînes : '007', '3.14'. Sans guillemets, ils seraient interprétés comme des entiers ou des flottants.
  • Les chaînes contenant des caractères comme :, #, [, { ou un espace en début de chaîne, quand une sortie nue changerait la structure.

Nettoyages appliqués à chaque exécution

  • Espaces en fin de ligne. Supprimés.
  • Indentation mélangée ou irrégulière. Normalisée à la largeur d’indentation choisie.
  • Lignes vides dans les collections. Supprimées.
  • Tabulations dans l’indentation. YAML les interdit ; le parseur rejette l’entrée avec une erreur claire qui pointe la ligne fautive, pour que vous puissiez corriger au lieu de livrer un fichier que d’autres parseurs refuseront.

Commentaires, ancres et clés de fusion

Le formatage normalise le modèle du document, ce qui a des limites à connaître avant de commiter :

  • Les commentaires sont supprimés. Le parseur résout le document en données, donc les commentaires # ne survivent pas au formatage. Gardez une copie si vos commentaires comptent.
  • Les ancres et les alias sont résolus. Les nœuds partagés via un alias restent partagés, mais ils sont réémis avec des noms générés comme &ref_0 ; les noms d’ancre d’origine ne sont pas conservés.
  • Les clés de fusion (<<:) sont résolues en mappings ordinaires, avec les valeurs fusionnées en place.

Flux multi-documents

Les flux de plusieurs documents sont pris en charge : chaque document est formaté indépendamment, puis les documents sont réassemblés avec le séparateur ---, jusqu’à 100 documents par exécution.

Questions fréquentes

La structure et les valeurs restent identiques : seul le rendu change (indentation, guillemets, flux ou bloc, ordre des clés si vous activez le tri). Deux choses ne sont pas conservées, à dessein : les commentaires sont supprimés et les noms d’ancres sont régénérés.

Quand une chaîne nue serait interprétée comme autre chose, les guillemets sont nécessaires par sécurité. Cas courants : des clés ou valeurs composées uniquement de chiffres, des chaînes contenant : ou #, et des booléens hérités comme yes et no que les parseurs YAML 1.1 liraient comme true/false.

Non. L’option de style s’applique à tout le document : le bloc déplie chaque collection sur ses propres lignes, le flux affiche les collections en ligne. Formatez deux fois avec des options différentes si vous devez comparer.

Non. L’analyse et le formatage s’exécutent dans votre navigateur avec le moteur js-yaml embarqué. Votre YAML ne passe pas par le serveur, n’est pas stocké et n’apparaît jamais dans l’adresse de la page ; il ne vit que dans cette session du navigateur pour que la vue en plusieurs étapes puisse afficher votre résultat.

Outils similaires