YAML Formatter
NovitàValidate, beautify, and convert YAML online. Real-time syntax highlighting, error detection with line numbers, and one-click JSON export.
Input
Formatted output
← paste YAML to see formatted outputRuns entirely in your browser. Nothing is uploaded.
Formatta e valida YAML istantaneamente nel tuo browser
Il formattatore YAML valida e abbellisce il tuo YAML in tempo reale mentre scrivi o incolli — senza dover premere nessun pulsante. Normalizza l'indentazione, evidenzia gli errori di sintassi con numeri di riga e spiegazioni, e offre la conversione in JSON con un clic. L'editor ha un'evidenziazione completa della sintassi usando proprietà CSS personalizzate che si adattano alla preferenza di modalità scura o chiara del sistema. Tutto funziona lato client usando un parser YAML JavaScript — i tuoi file di configurazione non lasciano mai il tuo dispositivo.
YAML (YAML Ain't Markup Language) è usato in quasi tutti i moderni progetti software: workflow GitHub Actions, manifest Kubernetes, file Docker Compose, playbook Ansible, chart Helm, configurazioni CI/CD e file di configurazione delle applicazioni. È progettato per essere leggibile dall'uomo, ma la sua sensibilità all'indentazione e i caratteri speciali rendono sorprendentemente facile scrivere YAML non valido che fallisce solo in fase di esecuzione — quando è troppo tardi. Un formattatore live rileva quegli errori in pochi secondi.
Errori YAML comuni e come il validatore li individua
L'errore YAML più comune è l'uso di tabulazioni invece di spazi. YAML vieta i caratteri di tabulazione nell'indentazione — sembrano identici agli spazi nella maggior parte degli editor di testo ma causano immediati errori di analisi. Il validatore lo rileva e ti dice esattamente quale riga contiene la tabulazione. Il secondo errore più comune sono i due punti senza virgolette nei valori: `title: Hello: World` è ambiguo — il parser vede una chiave annidata. Metti il valore tra virgolette: `title: "Hello: World"`. Il terzo è l'indentazione inconsistente: se un blocco è indentato di 2 spazi in un posto e di 3 in un altro, il parser può leggere male il livello di annidamento.
Altri errori comuni: chiavi duplicate nello stesso mapping (tecnicamente consentite in YAML 1.1 ma illegali in 1.2 e rifiutate dalla maggior parte dei parser); spazi mancanti dopo i due punti (`chiave:valore` non è valido, serve `chiave: valore`); ancorages e alias usati in modo errato; e sorprese di coercizione implicita del tipo (la stringa `yes` diventa un booleano `true` nei parser YAML 1.1). Il validatore segnala ognuno di questi con un linguaggio chiaro, non solo un dump grezzo dell'errore del parser.
Conversione YAML in JSON — quando e perché
JSON e YAML sono formati di dati semanticamente equivalenti (con alcune eccezioni). YAML è un superset di JSON — il JSON valido è anche YAML valido. Convertire YAML in JSON è utile quando si lavora con strumenti o API che accettano solo JSON, o quando vuoi usare `jq` per interrogare un file di configurazione YAML (jq opera su JSON). Il pulsante "Copia come JSON" analizza il tuo YAML e lo serializza in JSON formattato con indentazione di 2 spazi.
Una nota importante: i commenti YAML (righe che iniziano con `#`) non vengono preservati nell'output JSON perché JSON non ha una sintassi per i commenti. Gli ancorages e gli alias YAML vengono risolti — il JSON mostra i valori finali dereferenziati. YAML multi-documento (più documenti separati da `---`) viene convertito in un array JSON contenente ogni documento come elemento. Se hai bisogno dell'operazione inversa (JSON in YAML), incolla il JSON in questo formattatore — dato che il JSON è YAML valido, verrà analizzato e riformattato in modo pulito.
Formattatore YAML vs yamllint, YAML Lint e YAML Checker
yamllint è lo strumento CLI di riferimento per il linting YAML — approfondito, configurabile e usato nelle pipeline CI. Ma richiede Python, pip e un terminale, rendendolo inaccessibile per controlli rapidi sulla macchina di un membro del team o in un ambiente browser. YAML Lint (yamllint.com) è la più popolare alternativa online ma mostra solo gli errori — nessuna formattazione, nessuna evidenziazione della sintassi, nessuna conversione JSON. YAML Checker (yamlchecker.com) formatta e valida ma ha un semplice textarea senza evidenziazione e senza output JSON. Transform.tools fa la conversione YAML-JSON ma senza validazione live.
Questo formattatore combina tutte queste funzionalità in un unico posto: validazione live con spiegazioni degli errori, output formattato con evidenziazione della sintassi, conversione JSON con un clic e supporto multi-documento — tutto nel tuo browser senza backend. È il percorso più rapido da "questo YAML è valido?" a "ecco la versione formattata e senza errori" per gli sviluppatori che preferiscono non installare strumenti o iscriversi a servizi.
Usi pratici — Kubernetes, GitHub Actions, Docker Compose
Per gli utenti Kubernetes: incolla il tuo manifest prima di applicarlo con `kubectl apply` per individuare gli errori di sintassi in anticipo. Un singolo errore di indentazione in una specifica Pod o in una definizione Service farà fallire `kubectl` con un errore criptico; individuarlo qui prima fa risparmiare tempo. Per gli utenti GitHub Actions: incolla il tuo file `.github/workflows/*.yml` per validarlo prima del commit. I workflow malformati falliscono silenziosamente (l'azione semplicemente non viene eseguita) e il debug nell'interfaccia GitHub è lento. Per gli utenti Docker Compose: valida il tuo `docker-compose.yml` prima di eseguire `docker compose up` — particolarmente importante per i file multi-servizio dove un errore in una definizione di servizio annidata può essere difficile da individuare.
Per gli utenti Ansible: incolla playbook, file di inventario o file di variabili per validare la struttura YAML prima di eseguire `ansible-playbook`. Per gli autori di chart Helm: valida il tuo `values.yaml` o i template del chart. Per chiunque scriva configurazioni CI/CD in YAML (GitLab CI, CircleCI, Bitbucket Pipelines, Travis CI): incolla la configurazione e validala prima del push. In tutti questi casi, il costo di un file YAML non valido è una build o un deployment falliti — individuarlo qui prima è sempre più veloce.
Frequently asked questions
Come formatto YAML online?
Incolla il tuo YAML nell'editor a sinistra e viene automaticamente formattato e validato in tempo reale a destra. Il formattatore normalizza l'indentazione a 2 spazi, rimuove gli spazi finali e visualizza il YAML con l'evidenziazione della sintassi. Se ci sono errori di sintassi, vengono evidenziati inline con una spiegazione di cosa c'è di sbagliato e in quale riga si trova il problema. Nessun pulsante da premere — la formattazione avviene mentre scrivi o incolli.
Come valido YAML per rilevare errori di sintassi?
Incolla il tuo YAML e il validatore lo analizza immediatamente usando un parser YAML lato client. Se il YAML non è valido, vedrai un banner di errore rosso con il messaggio di errore specifico e il numero di riga — lo stesso tipo di errore che una pipeline CI/CD (come GitHub Actions o Kubernetes) genererebbe. Gli errori YAML comuni includono indentazione errata (tabulazioni invece di spazi — YAML richiede spazi), due punti mancanti dopo le chiavi, chiavi duplicate o caratteri speciali senza virgolette come i due punti nei valori.
Posso convertire YAML in JSON?
Sì — c'è un pulsante "Copia come JSON" che analizza il tuo YAML e produce il JSON equivalente, formattato e pronto per l'uso. È utile quando hai un file di configurazione YAML (come un workflow GitHub Actions o un manifest Kubernetes) e hai bisogno degli stessi dati in formato JSON per un'API, uno script o uno strumento che accetta solo JSON. La conversione è senza perdita per il YAML standard — i commenti non vengono preservati in JSON poiché JSON non ha sintassi per i commenti.
Perché YAML ha bisogno di un formattatore?
YAML è sensibile all'indentazione: un singolo spazio extra o un carattere di tabulazione dove ci si aspetta uno spazio interromperà l'analisi. Questo rende la modifica manuale di YAML soggetta a errori, specialmente nelle configurazioni profondamente annidate come i manifest Kubernetes, i file Docker Compose, i workflow GitHub Actions e i playbook Ansible. Un formattatore applica un'indentazione coerente, normalizza gli spazi finali e rileva gli errori di sintassi prima che raggiungano una pipeline CI/CD o un deployment.
Il mio YAML rimane privato?
Sì — tutto funziona nel tuo browser. Il tuo codice YAML non viene mai inviato a nessun server, mai memorizzato e mai registrato. Questo è particolarmente importante per i file YAML che possono contenere segreti di configurazione, chiavi API o credenziali del database. A differenza degli strumenti YAML basati sul web che inviano il tuo contenuto a un backend per l'elaborazione, questo formattatore analizza e formatta completamente nel tuo browser usando JavaScript.
Funziona su iPhone e Android?
Sì. L'editor è responsive e funziona in Safari su iPhone e Chrome su Android. Incollare YAML dagli appunti funziona su mobile, e l'output formattato e i messaggi di errore vengono visualizzati chiaramente su schermi piccoli. Poiché tutto è lato client, la formattazione è istantanea senza round-trip al server.
Devo registrarmi o pagare?
No. Il formattatore YAML è completamente gratuito, senza account richiesto e senza limiti di utilizzo. Puoi formattare, validare e convertire tutto il YAML che vuoi. Sarà sempre gratuito.
Related tools
Vedi tutti gli strumenti
Novità Confronto testi (Diff)
Confronta due testi ed evidenzia ogni differenza, affiancati o in linea.
Novità Codifica / Decodifica URL
Codifica o decodifica testo in percent-encoding e analizza le query string, tutto nel tuo browser.
Novità Codifica / Decodifica entità HTML
Esegui l’escape e l’unescape delle entità HTML, con codifica numerica opzionale.
Novità Generatore di espressioni Cron
Spiega una pianificazione Cron in parole semplici e visualizza le prossime esecuzioni.
Novità Minificatore HTML
Comprimi l’HTML rimuovendo i commenti e gli spazi superflui.
Novità Minificatore CSS
Riduci il CSS eliminando commenti e spazi non necessari.