Formattatore e Validatore YAML - Correggi il rientro, trova l’errore
Formattatore e validatore YAML
Cosa fa questo strumento
YAML non ha parentesi graffe: la struttura sta nel rientro. Questo lo rende piacevole da leggere e facile da rompere — uno spazio di troppo e una chiave finisce sotto il genitore sbagliato. Questo strumento reindenta il documento a una larghezza sola, ti dice dov’è rotto e mostra come viene letto davvero.
Come si usa
- 1 Incolla il tuo YAML nel riquadro e scegli la larghezza del rientro: due spazi è la scelta comune.
- 2 Premi Formatta per reindentare, oppure Valida per controllarlo senza cambiare un carattere.
- 3 Non sei sicuro che un valore venga letto come intendevi? Premi In JSON e guarda.
I tab non sono rientro
La specifica YAML vieta i tab nel rientro e la maggior parte dei parser rifiuta il file in blocco. Il messaggio che stampano aiuta di rado, perché la riga accusata è spesso quella dopo il problema vero. Questo strumento indica la riga che contiene il tab.
I tuoi commenti restano
Molti formattatori analizzano il documento in un albero e lo ristampano. È ordinato, e cancella ogni commento che hai scritto — inutilizzabile per un docker-compose o una pipeline CI. Questo riscrive solo lo spazio iniziale: commenti, ordine delle chiavi e stile delle virgolette restano come li hai lasciati.
Perché NO è diventato false
In YAML 1.1 le parole nude yes, no, on e off erano booleani. Un elenco di paesi con il codice NO per la Norvegia veniva quindi caricato come false — un bug abbastanza famoso da avere un nome. YAML 1.2 ha eliminato quella regola e questo strumento segue la 1.2: solo true, false e null sono parole chiave. Se vuoi un booleano scrivi true o false; se vuoi il testo, ce l’hai già.
Ancore, alias e scalari a blocco
Un’ancora (&nome) marca un nodo perché un alias (*nome) possa riusarlo più avanti — comodo con definizioni di servizio ripetute. Gli scalari a blocco (| e >) portano testo multiriga: la barra verticale conserva gli a capo, la parentesi angolare li ripiega in spazi. Tutti e tre sono compresi qui, e il rientro dentro uno scalare a blocco è trattato come dato, non come formattazione.