Convertir entre JSON et YAML

Cet outil transforme un document YAML en JSON et inversement, en préservant la structure des données (objets, tableaux, types scalaires). La conversion JSON vers YAML, ou YAML vers JSON, est une opération courante en développement : on génère un fichier OpenAPI YAML à partir d'une spec JSON, on convertit la sortie d'une API REST en YAML pour la commiter dans un dépôt de configuration, on traduit un manifeste Kubernetes YAML en JSON pour le passer à kubectl --dry-run=client -o json, ou on aligne un workflow GitHub Actions avec un schéma JSON. Plus largement, c'est le pont entre le monde de l'échange de données (JSON) et celui de la configuration éditable à la main (YAML).

JSON et YAML adressent des besoins proches mais des cas d'usage différents. Le tableau suivant résume les différences techniques majeures, utiles pour choisir entre les deux selon le contexte.

JSON s'impose dès qu'un programme parle à un autre programme. Ses cas d'usage typiques :

• APIs REST et GraphQL : payloads de requête et de réponse.
• Échange de données entre microservices et files de messages.
• Code JavaScript natif : JSON.parse et JSON.stringify sans dépendance.
• Stockage côté navigateur : localStorage, sessionStorage, IndexedDB.
• Requêtes AJAX et fetch.
• Variantes binaires ou orientées flux : BSON (MongoDB), JSON Lines (logs, datasets ML), MessagePack.
• Configuration d'outils JS / TS : package.json, tsconfig.json, composer.json.

YAML s'impose dès qu'un humain édite régulièrement le fichier. Ses cas d'usage typiques :

• Docker Compose (docker-compose.yml) et profils de stack.
• Manifestes Kubernetes (Deployment, Service, Ingress, Helm charts).
• Playbooks Ansible et inventaires.
• Pipelines CI/CD : GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Spécifications OpenAPI / Swagger et AsyncAPI.
• Configuration applicative annotée (Symfony, Spring Boot, Rails) où les commentaires sont utiles.
• Fichiers édités fréquemment à la main, où la concision et la lisibilité priment sur la vitesse de parsing.

YAML est plus permissif que JSON, ce qui en fait un format puissant mais traître. Les pièges les plus fréquents :

• Indentation : les tabulations sont interdites par la spécification, seuls les espaces sont valides. Mélanger les deux ou changer le nombre d'espaces dans un même bloc casse le parsing.
• Coercition automatique des scalaires : yes, no, on, off, true, false, null, None, ~ sont parsés en booléens ou en null. Exemple piège : un code postal 01234 non quoté devient l'entier 1234, et un nom de pays NO (Norvège) devient false. Toujours mettre entre guillemets les chaînes ambiguës.
• Strings multilignes : | (block literal) conserve les sauts de ligne tels quels, alors que > (folded) remplace les sauts de ligne par des espaces. Les indicateurs de chomping - et + ajustent le comportement sur le saut final.
• YAML 1.1 vs 1.2 : la 1.1 (encore très répandue, par exemple via PyYAML par défaut) traite yes/no/on/off comme booléens, ce que la 1.2 a supprimé. Les comportements diffèrent aussi sur les nombres en base 8.
• Dates implicites : 2024-01-15 sans guillemets est interprété comme un objet date par certains parseurs, pas comme une chaîne.

Le même document, exprimé en JSON puis en YAML. Configuration simple d'une application avec ses dépendances et son environnement :

Version JSON

{
    "name": "cdrn-app",
    "version": "1.14.2",
    "environment": "production",
    "dependencies": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": false
}

Version YAML équivalente

# Configuration de l'application
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

La version YAML est plus courte d'environ 25 % en caractères, accepte un commentaire en tête et se lit comme une liste de propriétés sans bruit syntaxique.

Étapes pour convertir vos données :

1. Collez votre document source (JSON ou YAML) dans le champ d'entrée.
2. Sélectionnez le sens de conversion souhaité (JSON vers YAML, ou YAML vers JSON).
3. Cliquez sur le bouton de conversion : le résultat formaté apparaît dans la zone de sortie.
4. Vérifiez le rendu, puis utilisez le bouton de copie pour récupérer le résultat dans votre presse-papier.

La conversion est effectuée localement dans votre navigateur ou via une route serveur dédiée selon le tooling : aucune donnée sensible n'est conservée.