acento.io
Strumento per sviluppatori

Convertitore JSON ↔ YAML

Converti JSON in YAML o YAML in JSON istantaneamente, direttamente nel browser — senza upload, senza server.

By Carlos Suárez , Systems engineer
Last updated:

Cosa fa questo JSON ↔ YAML converter

Questo strumento converte JSON in YAML e YAML in JSON in modo bidirezionale, usando la libreria js-yaml. I tipi vengono preservati fedelmente: i numeri rimangono numeri, i booleani rimangono booleani, gli array e le mappe mantengono la loro struttura. La vista affiancata ti permette di confrontare i due formati e il tasto Inverti scambia input e output in un click. Una nota di onestà che trovi raramente altrove: i commenti YAML non sopravvivono alla conversione in JSON, perché JSON.parse non prevede commenti per specifica. Allo stesso modo, le ancore YAML (&) e gli alias (*) vengono espansi nell'output JSON. Lo strumento ti avvisa quando rileva commenti nel tuo YAML. 100% lato client — i tuoi dati non lasciano mai il browser. Nessun upload, nessun tracciamento, nessun log sul server.

Funzionalità

  • Conversione bidirezionale. Passa da JSON a YAML o da YAML a JSON con un click. Il tasto Inverti scambia le due direzioni senza ricaricare la pagina.
  • Tipi preservati. Numeri, booleani, null, array e oggetti annidati vengono mappati correttamente in entrambe le direzioni, senza trasformare tutto in stringhe.
  • Avviso commenti e ancore. Se il tuo YAML contiene commenti o ancore (&/*), lo strumento ti avvisa prima della conversione, così sai esattamente cosa andrà perso.
  • Errori di parsing in tempo reale. JSON o YAML non valido? Il parser mostra subito l'errore con riga e colonna, così trovi il problema in secondi invece di dover cercare a occhio.
  • Copia con un click. Il pulsante Copia trasferisce l'output negli appunti istantaneamente. Utile quando lavori tra terminale, editor e browser senza perdere tempo.
  • Integrazione con altri strumenti. Se hai bisogno di formattare o validare il JSON risultante, il [JSON formatter](/it/json-formatter/) è a portata di mano. Per generare interfacce TypeScript dal JSON, prova il [JSON to TypeScript](/it/json-to-typescript/).

Come usare il JSON ↔ YAML converter

Incolla il tuo JSON o YAML nell'area di input, scegli la direzione e ottieni l'output in tempo reale.

  1. Scegli la direzione. Clicca su JSON → YAML oppure YAML → JSON in base al formato di partenza.
  2. Incolla il contenuto. Incolla il tuo testo nell'area sinistra. Ad esempio, un manifest Kubernetes come {"apiVersion": "v1", "kind": "Pod"} viene convertito in YAML valido in automatico.
  3. Leggi l'output. L'output appare immediatamente nell'area destra. Se ci sono errori di sintassi, viene mostrato un messaggio con la posizione esatta.
  4. Copia o inverti. Usa il pulsante Copia per prendere il risultato, oppure Inverti per scambiare input e output e proseguire il lavoro nell'altra direzione.

Casi d'uso comuni

  • Manifest Kubernetes. I manifest Kubernetes vivono in YAML per la leggibilità umana, ma le API REST di Kubernetes accettano JSON. Questo strumento converte in un senso o nell'altro quando hai bisogno di fare chiamate curl o debug con strumenti JSON.
  • Pipeline CI/CD. I file di configurazione di GitHub Actions e GitLab CI sono in YAML, ma spesso vuoi ispezioniare la struttura con jq o altri tool JSON. Incolla il .gitlab-ci.yml, converti e analizza.
  • Migrazione tra sistemi. Quando un sistema esporta in JSON e un altro si aspetta YAML — o viceversa — questo converter elimina la conversione manuale che introduce errori di indentazione e tipi sbagliati.
  • Validazione rapida. Un YAML o JSON che non si comporta come ti aspetti? Incollalo qui: se il parser lancia un errore, hai trovato il problema. Se la conversione riesce, la struttura è valida.
  • Conformità PA italiana. L'AGID prescrive UTF-8 per tutti i servizi digitali della Pubblica Amministrazione. Quando esporti configurazioni da sistemi legacy in YAML, convertire in JSON e verificare l'encoding è un passaggio di validazione utile.

Domande frequenti

I miei dati vengono inviati a un server?

No. Questa versione italiana dello strumento gira interamente nel tuo browser. Nessun byte del tuo JSON o YAML lascia il dispositivo: niente upload, niente log, niente analytics sui contenuti.

Perché i miei commenti YAML scompaiono dopo la conversione?

JSON non supporta i commenti per specifica. Quando converti YAML in JSON e poi torni indietro, i commenti sono già stati scartati nel primo passaggio. Lo strumento ti avvisa quando rileva commenti nel YAML di input, prima di procedere.

Cosa succede alle ancore e agli alias YAML?

Le ancore (&nome) e gli alias (*nome) vengono espansi: ogni alias viene sostituito con una copia completa del valore a cui punta. Il JSON risultante è corretto, ma non mantiene la struttura condivisa originale del YAML.

Il valore 'no' in YAML è un booleano o una stringa?

Dipende dalla versione dello spec. In YAML 1.1 (usata da molti parser tradizionali) no, off, false sono tutti booleani. In YAML 1.2 solo true e false sono booleani. js-yaml usa la semantica 1.2, quindi no diventa la stringa "no" nel JSON di output.

Posso usare tab per l'indentazione in YAML?

No. Lo standard YAML vieta esplicitamente i tab come caratteri di indentazione: sono ammessi solo spazi. Se incolli YAML con tab, il parser restituirà un errore di parsing con la riga esatta del problema.

Questo strumento funziona con YAML multilinea (blocchi letterali)?

Sì. I blocchi letterali YAML (|) e i blocchi ripiegati (>) vengono convertiti in stringhe JSON con newline preservati o collassati rispettivamente, seguendo la semantica js-yaml.