YAML

YAML (YAML Ain't Markup Language) est un format de sérialisation de données orienté configuration utilisant l'indentation pour la hiérarchie, prenant en charge commentaires et références, et mieux adapté à l'édition manuelle que JSON.

Objectif

Fournir un format de configuration plus facile à écrire et maintenir à la main que JSON, avec commentaires, documents multiples et références par ancres.

Mécanisme

L'indentation (espaces, jamais de tabulations) exprime l'imbrication, les deux-points séparent clés et valeurs, les tirets marquent les éléments de liste. Prend en charge commentaires (#), documents multiples (---) et ancres (&) avec alias (*) pour les références. Attention à l'inférence de types (yes/no devenant des booléens).

Cas d’usage

Configuration CI/CD (GitHub Actions, GitLab CI)
Manifestes Kubernetes
Docker Compose
Fichiers de configuration d'applications

Exemples

entrée

name: Ada
age: 36

Output

The object {name:"Ada", age:36}

Indentation expresses hierarchy

Erreurs courantes

Indenting with tabs (YAML allows spaces only): Use spaces for indentation consistently

Termes associés

JSON (JavaScript Object Notation) est un format léger d'échange de données fondé sur les littéraux d'objets JavaScript, utilisant paires clé-valeur et tableaux.

TOML (Tom's Obvious, Minimal Language) est un format orienté configuration qui représente les données avec des tables et des paires clé-valeur, à sémantique explicite et sans inférence de types implicite.

XML (Extensible Markup Language) est le langage de balisage standard du W3C décrivant des données par un arbre de balises, prenant en charge espaces de noms, validation par schéma et transformation de styles.

INI est un format traditionnel de fichier de configuration qui regroupe les réglages avec des en-têtes [section] et des paires key=value ; il est simple mais non standardisé, et les implémentations diffèrent légèrement.

Le frontmatter est un bloc de métadonnées YAML/TOML/JSON placé en tête d'un document, délimité par ---, couramment utilisé par les générateurs de sites statiques.

Outils associés

Convertisseur YAML

Convert between YAML and JSON online. Gratuit, privé et 100% côté client.

Convertisseur JSON ↔ YAML

Convert between JSON and YAML formats online. Gratuit, privé et 100% côté client.

Yaml To Xml — outil 100% côté client. Confidentialité d'abord, sans aller-retour serveur.

Yaml To Csv — outil 100% côté client. Confidentialité d'abord, sans aller-retour serveur.

Tutoriels associés

JSON vs YAML for configuration: syntax, pitfalls, and how to choose

Where YAML buys you ergonomics, where it quietly coerces your data, why JSON stays the machine boundary, and a practical decision rule for config files.

References