YAML in JSON

Cos'è la conversione da YAML a JSON?

La conversione da YAML a JSON trasforma i dati scritti in YAML (YAML Ain't Markup Language) in JSON (JavaScript Object Notation). Entrambi i formati rappresentano dati strutturati come coppie chiave-valore, sequenze e oggetti annidati, ma differiscono nella sintassi. YAML usa l'indentazione e una punteggiatura minimale, mentre JSON usa parentesi graffe, parentesi quadre e virgolette obbligatorie. Convertire tra i due è un'operazione comune quando si trasferiscono dati di configurazione tra sistemi che si aspettano formati diversi.

YAML è stato progettato per la leggibilità umana. Supporta commenti, stringhe multi-riga, ancore e alias, nessuno dei quali esiste in JSON. Quando si converte YAML in JSON, queste funzionalità specifiche di YAML vengono risolte: le ancore vengono espanse inline, i commenti vengono eliminati e i blocchi multi-riga diventano stringhe con escape. L'output è JSON valido che qualsiasi parser JSON è in grado di leggere.

La specifica YAML 1.2 definisce esplicitamente JSON come un sottoinsieme di YAML, il che significa che ogni documento JSON valido è anche YAML valido. Il contrario non è vero. I documenti YAML che usano commenti, ancore o chiavi complesse non hanno un equivalente JSON diretto e devono essere semplificati durante la conversione. Questo strumento gestisce la conversione automaticamente, producendo JSON pulito e ben formattato da qualsiasi input YAML valido.

YAML 1.2 Specification — yaml.org →

Perché usare un convertitore YAML in JSON online?

Convertire YAML in JSON a mano è soggetto a errori, specialmente con strutture profondamente annidate o valori multi-riga. Un convertitore basato sul browser fornisce il risultato istantaneamente e intercetta gli errori di sintassi YAML prima che raggiungano l'applicazione.

Casi d'uso della conversione YAML in JSON

Riferimento alla mappatura dei tipi da YAML a JSON

Ogni tipo di dato YAML si mappa a un tipo JSON specifico durante la conversione. La tabella seguente mostra ogni costrutto YAML con il corrispondente output JSON. Comprendere queste mappature aiuta a prevedere come appariranno i dati YAML dopo la conversione ed evitare sorprese con tipi come booleani o valori null.

Sintassi YAML vs JSON

YAML e JSON rappresentano lo stesso modello di dati ma con regole sintattiche diverse. Le differenze seguenti spiegano perché alcune funzionalità di YAML — come commenti e ancore — non hanno un equivalente JSON.

Esempi di codice

Di seguito sono riportati esempi funzionanti per la conversione programmatica da YAML a JSON. Ogni esempio analizza una stringa YAML e produce JSON formattato.

import { load } from 'js-yaml'

const yamlStr = `
server:
  host: localhost
  port: 8080
  ssl: true
`

const json = JSON.stringify(load(yamlStr), null, 2)
console.log(json)
// → {
// →   "server": {
// →     "host": "localhost",
// →     "port": 8080,
// →     "ssl": true
// →   }
// → }

import yaml, json

yaml_str = """
database:
  host: db.example.com
  port: 5432
  credentials:
    user: admin
    password: s3cret
"""

data = yaml.safe_load(yaml_str)
print(json.dumps(data, indent=2))
# → {
# →   "database": {
# →     "host": "db.example.com",
# →     "port": 5432,
# →     "credentials": {
# →       "user": "admin",
# →       "password": "s3cret"
# →     }
# →   }
# → }

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"gopkg.in/yaml.v3"
)

func main() {
	yamlData := []byte(`
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
`)

	var obj map[string]interface{}
	if err := yaml.Unmarshal(yamlData, &obj); err != nil {
		log.Fatal(err)
	}
	jsonBytes, _ := json.MarshalIndent(obj, "", "  ")
	fmt.Println(string(jsonBytes))
	// → { "services": { "web": { "image": "nginx:latest", "ports": ["80:80"] } } }
}

# Convert a YAML file to JSON with yq
yq -o=json config.yaml > config.json

# Pipe YAML into yq for one-off conversion
echo "name: demo" | yq -o=json
# → { "name": "demo" }

# Python one-liner (no extra install on most systems)
python3 -c "import yaml, json, sys; print(json.dumps(yaml.safe_load(sys.stdin), indent=2))" < config.yaml

Domande frequenti