Validatore e formattatore YAML

Incolla lo YAML per controllarne la sintassi, individuare gli errori e ottenere un output pulito e formattato in modo coerente.

Opzioni di output

YAMLinput

Vuoto

YAMLoutput

L'output YAML appare qui

Funziona interamente nel tuo browser: nulla viene caricato. Si applicano limiti di uso corretto (5 MB per input, numero di conversioni limitato) per prevenire spam e bot.

Carica da URL

Il file viene recuperato direttamente dal tuo browser, quindi il server deve consentire le richieste cross-origin.

Scorciatoie da tastiera

Ctrl / ⌘ + Enter Converti ora
Ctrl / ⌘ + S Scarica l'output
Alt + Shift + C Copia l'output
Alt + Shift + F Ripara e formatta il JSON di input
Alt + Shift + S Inverti la direzione
Alt + Shift + T Passa tra le viste codice, albero e mappa
Ctrl / ⌘ + Z Annulla, anche dopo Formatta, Ripara e Cancella
Esc Esci da schermo intero
Dimensione del testo nell'editor

Normalizza lo YAML disordinato

Indentazione mista, mappe in linea e virgolette superflue superano il parsing ma rendono difficile la revisione. L'output formattato dà a ogni file la stessa forma.

Input
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
Formattato
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

Errori YAML comuni e come correggerli

Questi sono i messaggi che vedrai più spesso, in questo validatore e in strumenti come kubectl, Helm e docker compose.

Messaggio di erroreCosa significa e come correggerlo
tab characters must not be used in indentation YAML ammette solo spazi per l'indentazione. Sostituisci ogni tabulazione con spazi.
bad indentation of a mapping entry Una chiave è indentata diversamente dalle chiavi sorelle, oppure un valore semplice contiene ": ". Allinea la chiave alle vicine, oppure metti il valore tra virgolette.
mapping values are not allowed in this context Lo stesso problema come lo segnalano kubectl e Helm: di solito un valore senza virgolette che contiene ": ", come un URL o un orario. Metti il valore tra virgolette.
end of the stream or a document separator is expected Un elemento di lista o una chiave si trova al livello di indentazione sbagliato, ad esempio una lista seguita da una mappatura allo stesso livello.
unexpected end of the stream within a flow collection Una lista in linea [ … ] o una mappa { … } non viene mai chiusa. Aggiungi la parentesi mancante.
duplicated mapping key La stessa chiave compare due volte in una mappatura. Rimuovine o rinominane una.
unidentified alias Un alias come *defaults è usato prima della sua ancora &defaults, o senza di essa.

Cosa controlla il validatore

Rompi il file di proposito con i pulsanti e guarda quale controllo se ne accorge.

Sintassi e indentazione

Tabulazioni, chiavi disallineate, virgolette e parentesi non chiuse vengono segnalate con riga e colonna esatte.

Chiavi duplicate

Una chiave definita due volte nella stessa mappatura è un errore, mentre alcuni parser tengono l'ultimo valore senza avvisare.

Ancore e alias

Ogni alias deve puntare a un'ancora definita prima nel documento, e le chiavi di merge devono riferirsi a mappature.

Più documenti

Ogni documento di un file separato da --- viene analizzato, e le note mostrano quanti ne sono stati trovati.

Privato per impostazione predefinita

La validazione avviene nel tuo browser, quindi i segreti nei file CI e nei manifest non lasciano mai il tuo computer.

Altri strumenti

Convertitori, validatori e guide passo passo per ogni punto in cui JSON e YAML si incontrano.

Domande frequenti

Come valido lo YAML online?

Incolla il tuo YAML o trascina un file .yaml o .yml. Il badge mostra YAML valido o YAML non valido mentre scrivi. Per un file non valido ottieni il messaggio di errore con riga e colonna esatte, e la riga viene evidenziata nell'editor.

A cosa serve l'output formattato?

Riscrive gli stessi dati con indentazione e virgolette coerenti: stile a blocco, l'indentazione che hai scelto e virgolette solo dove servono. È un modo rapido per normalizzare un file prima del commit.

I commenti vengono mantenuti nell'output formattato?

No. Il validatore analizza lo YAML trasformandolo in dati e lo riscrive, e i commenti non fanno parte dei dati. Usa l'output per controllare la struttura e conserva il file originale se i suoi commenti sono importanti.

Posso validare un file YAML multi-documento?

Sì. I documenti separati da --- vengono controllati uno per uno, e l'output formattato li mantiene come documenti separati. Le note sotto l'editor mostrano quanti documenti sono stati trovati.

Controlla gli schemi di Kubernetes o Docker Compose?

Controlla la sintassi YAML, non uno schema specifico. Un file può essere YAML valido ed essere comunque rifiutato da kubectl o docker compose per un campo sconosciuto. Usa kubectl apply --dry-run=server o docker compose config per i controlli dello schema.

Quale versione di YAML viene usata?

Il parsing segue lo schema core di YAML 1.2, quindi yes, no, on e off restano stringhe. Con «Sicuro per YAML 1.1» attivo, l'output mette quelle parole tra virgolette, così anche parser meno recenti come PyYAML le leggono come stringhe.