YAML Formatter : Valider et formater YAML

Qu'est-ce que YAML Formatter ?

YAML Formatter est un outil basé sur le navigateur qui analyse, valide et re-sérialise du texte YAML avec une indentation cohérente et configurable. La syntaxe sensible à l'indentation de YAML signifie qu'un seul bloc mal aligné peut modifier la signification d'un document entier ou produire une erreur difficile à localiser visuellement. Cet outil détecte ces problèmes immédiatement et produit une sortie propre correspondant à votre style préféré.

Au-delà du formatage de base, l'outil convertit YAML directement en JSON — utile quand une API ou un outil nécessite du JSON mais que votre configuration source est en YAML, ou quand vous devez vérifier que votre YAML se parse en la structure de données attendue. Les deux opérations s'exécutent entièrement dans votre navigateur avec la bibliothèque js-yaml. Aucune donnée ne quitte votre machine, aucun compte n'est requis, et l'outil est gratuit.

Fonctionnalités principales

• Formater YAML avec une indentation correcte — Analyse l'entrée avec js-yaml et la re-sérialise avec la taille d'indentation choisie. L'option lineWidth: -1 empêche le formatter d'introduire des sauts de ligne dans les longues chaînes, et noRefs: true développe les ancres et les alias en leurs valeurs complètes.
• Valider la syntaxe YAML avec des messages d'erreur — Si js-yaml génère une erreur d'analyse, le message d'erreur exact (avec le numéro de ligne) apparaît sous le panneau de sortie. Les erreurs utilisent un attribut accessible role="alert".
• Convertir YAML en JSON — Analyse le YAML et sérialise le résultat en JSON avec JSON.stringify et l'indentation sélectionnée. La logique de téléchargement détecte si la sortie commence par { ou [ et enregistre le fichier avec l'extension .json automatiquement.
• Copier la sortie formatée dans le presse-papiers — Utilise l'API Clipboard avec un fallback textarea.
• Télécharger en fichier .yaml ou .json — Quand la sortie est du JSON (depuis l'opération de conversion), le fichier est enregistré sous formatted.json. Quand la sortie est du YAML (depuis l'opération de formatage), il est enregistré sous formatted.yaml.
• Raccourcis clavier — Ctrl+Entrée (Cmd+Entrée) formate ; Ctrl+Shift+J (Cmd+Shift+J) convertit en JSON.

Comment utiliser YAML Formatter

Étape 1 : Coller votre YAML

Accédez à l'outil à /developer/code/yaml-formatter. Collez votre YAML dans le panneau de saisie à gauche. Le textarea est en police monospace et redimensionnable. Les documents YAML de n'importe quelle taille tenant dans la mémoire du navigateur sont acceptés — l'outil n'impose aucune restriction de taille.

Étape 2 : Choisir l'indentation

Ouvrez le menu déroulant d'indentation dans la barre d'actions sous les panneaux. Choisissez 2 espaces ou 4 espaces. La sélection affecte à la fois la sortie de Format et la sortie de conversion JSON. L'indentation à deux espaces est la norme de la communauté YAML et est utilisée par les manifestes Kubernetes, les playbooks Ansible et la plupart des fichiers de pipeline CI/CD. L'indentation à quatre espaces correspond à certaines conventions de projets Python et Java.

Étape 3 : Formater ou convertir

Cliquez sur Format (ou appuyez sur Ctrl+Entrée / Cmd+Entrée) pour produire une sortie YAML normalisée dans le panneau de droite. Cliquez sur To JSON (ou appuyez sur Ctrl+Shift+J / Cmd+Shift+J) pour produire un document JSON équivalent.

Exemple d'entrée — un manifest Kubernetes Deployment avec une indentation incohérente :

apiVersion: apps/v1
kind: Deployment
metadata:
    name: web-frontend
    labels:
      app: web
spec:
  replicas: 3
  selector:
      matchLabels:
        app: web
  template:
      metadata:
        labels:
          app: web
      spec:
        containers:
        - name: nginx
          image: nginx:1.25
          ports:
          - containerPort: 80

Sortie après Format avec indentation à 2 espaces :

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-frontend
  labels:
    app: web
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: nginx
          image: nginx:1.25
          ports:
            - containerPort: 80

Étape 4 : Convertir en JSON (optionnel)

Avec le même YAML en entrée, cliquez sur To JSON. Le panneau de sortie affiche le document JSON équivalent :

{
  "apiVersion": "apps/v1",
  "kind": "Deployment",
  "metadata": {
    "name": "web-frontend",
    "labels": {
      "app": "web"
    }
  }
}

(Tronqué par souci de concision — le document complet inclurait spec)

Étape 5 : Copier ou télécharger

Cliquez sur Copy pour copier la sortie dans votre presse-papiers. Cliquez sur Download pour enregistrer le fichier. L'outil choisit automatiquement .yaml ou .json comme extension de fichier selon que la sortie ressemble à du JSON (commence par { ou [).

Exemples pratiques

Normaliser un fichier de pipeline CI/CD

Un fichier de workflow GitHub Actions a été modifié par plusieurs contributeurs et présente une indentation mixte. Collez-le dans le formatter, cliquez sur Format avec indentation à 2 espaces, et la sortie montre une indentation cohérente dans tout le document. Avant de valider la modification, comparez l'entrée et la sortie pour confirmer qu'aucune différence sémantique n'a été introduite — puisque YAML est sensible à l'indentation, le reformatage peut révéler des bugs d'alignement qui se cachaient dans l'original.

Vérifier la structure de configuration

Vous maintenez un fichier de configuration pour une application Node.js déployée avec YAML, mais le runtime le lit comme un objet JavaScript parsé. Collez la configuration et cliquez sur To JSON. La sortie JSON montre exactement à quoi ressemble l'objet parsé, incluant les conversions de types (bare true/false → booléens, nombres non quotés → nombres). Cela confirme que des valeurs comme port: 8080 seront un nombre et non la chaîne "8080".

Entrée :

server:
  host: 0.0.0.0
  port: 8080
  debug: false
database:
  url: postgres://localhost:5432/myapp
  pool: 10

Sortie JSON :

{
  "server": {
    "host": "0.0.0.0",
    "port": 8080,
    "debug": false
  },
  "database": {
    "url": "postgres://localhost:5432/myapp",
    "pool": 10
  }
}

Développer les ancres YAML

YAML prend en charge les ancres (&) et les alias (*) pour réutiliser des valeurs. Le formatter utilise noRefs: true, ce qui signifie que tous les alias sont développés en leurs valeurs complètes dans la sortie. Cela rend le document formaté autonome et plus facile à lire dans les outils qui ne prennent pas en charge les ancres.

Conseils et bonnes pratiques

Le formatter préserve l'ordre des clés. Les options de dump de js-yaml incluent sortKeys: false, donc l'ordre de vos clés est maintenu tel quel dans la sortie formatée. C'est important pour les documents Kubernetes et Ansible où l'ordre des champs porte une convention même si ce n'est pas techniquement requis.

Les longues chaînes ne sont pas coupées. Le paramètre lineWidth: -1 désactive le retour à la ligne automatique. Les chaînes multilignes et les valeurs longues resteront sur une seule ligne plutôt que d'être coupées à une colonne arbitraire. Si vous avez besoin d'une sortie avec retour à la ligne, copiez le résultat et appliquez le retour à la ligne dans votre éditeur.

Validez avant de commiter dans le contrôle de version. Les erreurs d'indentation YAML sont une source fréquente d'échecs CI. Faites passer votre fichier de pipeline dans ce formatter avant de pousser. Un passage de format propre sans message d'erreur confirme que le YAML est syntaxiquement valide.

Vérifiez l'extension du fichier au téléchargement. La logique de téléchargement inspecte le contenu de la sortie, pas l'opération que vous avez effectuée. Si vous avez formaté du YAML et que le YAML commence par { (certains fichiers YAML utilisent la syntaxe compatible JSON), le fichier est enregistré en .json. Renommez-le si nécessaire.

Les booléens YAML sont stricts. La spécification YAML reconnaît true, false, yes, no, on et off comme valeurs booléennes en YAML 1.1. La bibliothèque js-yaml suit YAML 1.2 par défaut, où seuls true et false sont des booléens. Si votre YAML utilise yes/no, le formatter les traite comme des chaînes simples.

Problèmes courants et dépannage

Message d'erreur avec un numéro de ligne et de colonne — Les erreurs d'analyse de js-yaml incluent l'emplacement exact du problème. Regardez la ligne indiquée dans votre entrée. Les causes fréquentes sont : des tabulations utilisées pour l'indentation au lieu d'espaces (YAML n'autorise pas les tabulations), un deux-points dans une chaîne non quotée (par exemple, url: http://example.com doit être url: "http://example.com" ou utiliser un scalaire de bloc), ou un niveau d'imbrication incorrect.

La sortie manque des valeurs présentes dans l'entrée — Si votre YAML utilise des balises de type !! (par exemple, !!binary, !!timestamp) que js-yaml ne reconnaît pas, ces valeurs peuvent être supprimées ou transformées. Inspectez les valeurs spécifiques pour identifier la balise de type et quotez la valeur si nécessaire.

Erreur "Please enter YAML to format" — Le champ de saisie est vide ou ne contient que des espaces lorsque vous avez cliqué sur Format ou Convertir. Collez d'abord votre YAML dans le panneau de saisie.

Le JSON converti contient des valeurs null inattendues — Une valeur YAML de ~ ou une valeur vide (clé sans valeur après les deux-points) devient null en JSON. C'est le comportement correct et correspond à la spécification YAML. Quotez la valeur si vous vouliez la chaîne "~" ou une chaîne vide "".

Le téléchargement se fait en .json au lieu de .yaml — Le gestionnaire de téléchargement vérifie si la sortie commence par { ou [. Certains documents YAML sont écrits en syntaxe YAML compatible JSON et commencent par une accolade. Si c'est le cas avec votre sortie, renommez le fichier téléchargé en .yaml après l'enregistrement.

Confidentialité et sécurité

YAML Formatter traite toute l'entrée localement dans votre navigateur avec la bibliothèque js-yaml. Aucun texte que vous collez — y compris les chaînes de connexion aux bases de données, les tokens API, les clés privées ou les données de configuration personnelles — n'est envoyé à un serveur. L'outil fonctionne sans connexion réseau une fois la page chargée. Il n'y a pas de suivi de session sur les opérations de formatage.

Foire aux questions

YAML Formatter est-il gratuit ? Oui, entièrement gratuit sans limites d'utilisation. Toutes les opérations de formatage, validation et conversion sont disponibles sans frais. Les fonctionnalités de supporter de Glyph Widgets — préréglages sauvegardés, historique de session, notes d'outil — sont disponibles pour les supporters Ko-fi, mais la fonctionnalité YAML de base ne nécessite rien.

Fonctionne-t-il hors ligne ? Oui. Tout le traitement s'exécute dans votre navigateur. Une fois la page chargée, vous pouvez vous déconnecter d'internet et continuer à utiliser le formatter et le convertisseur sans interruption.

Mes données sont-elles en sécurité ? Oui. Votre entrée YAML n'est jamais transmise à un serveur. Elle réside uniquement dans la mémoire de votre navigateur et est effacée lorsque vous cliquez sur Effacer ou fermez l'onglet.

Le formatter prend-il en charge les fichiers YAML multi-documents (plusieurs sections ---) ? La fonction load de js-yaml analyse le premier document dans un flux. Les fichiers YAML multi-documents (séparés par ---) n'auront que leur premier document formaté. Utilisez le comportement de yaml.loadAll pour les fichiers multi-documents — mais cet outil ne traite actuellement que le premier document.

Quelle est la différence entre Format et To JSON ? Format re-sérialise le YAML analysé en YAML avec une indentation cohérente. To JSON sérialise les mêmes données analysées en document JSON. Les deux opérations utilisent la même étape d'analyse, donc elles valident toutes deux le YAML et échouent de manière identique sur une entrée invalide.

Le formatter préserve-t-il les commentaires ? Non. Le parser js-yaml supprime les commentaires lors de l'analyse. Après le formatage, les commentaires de l'entrée originale n'apparaîtront pas dans la sortie. Si vous avez besoin de préserver les commentaires, modifiez l'indentation manuellement dans votre fichier source.

Puis-je convertir JSON en YAML ? Cet outil convertit YAML en JSON. Pour convertir dans l'autre sens, utilisez l'outil Bientôt disponible: JSON Converter, qui prend en charge la conversion JSON vers YAML.

Quelle version YAML l'outil prend-il en charge ? La bibliothèque js-yaml implémente YAML 1.2, qui est plus stricte sur les valeurs booléennes et certains autres cas limites par rapport à YAML 1.1. La plupart des fichiers YAML modernes (Kubernetes, Docker Compose, GitHub Actions, etc.) sont écrits pour être compatibles avec YAML 1.2.

Quel est le raccourci clavier pour convertir en JSON ? Appuyez sur Ctrl+Shift+J sous Windows/Linux ou Cmd+Shift+J sous macOS pour déclencher l'opération de conversion en JSON. Appuyez sur Ctrl+Entrée ou Cmd+Entrée pour Formater.

L'extension du fichier au téléchargement reflète-t-elle l'opération effectuée ? Pas directement — le gestionnaire de téléchargement vérifie si le texte de sortie commence par { ou [ pour décider entre .json et .yaml. La sortie YAML formatée qui commence par un mapping sera enregistrée en .yaml, et la sortie convertie en JSON (qui commence toujours par { ou [) sera enregistrée en .json.

Outils connexes

JSON Formatter — Formater, valider et minifier JSON avec validation de schéma, génération de schéma et visualiseur d'arbre interactif.

XML Formatter — Formater et valider des documents XML avec les mêmes contrôles d'indentation et le support de minification.

Bientôt disponible: TOML Formatter — Formater et valider des fichiers de configuration TOML.

Essayez YAML Formatter maintenant : YAML Formatter