Punti salienti
- 01Formatta YAML con indentazione coerente utilizzando il parser js-yaml — la stessa libreria utilizzata negli strumenti di build di Node.js.
- 02Convalida la sintassi e segnala i numeri di riga esatti per gli errori.
- 03Converte tra YAML e JSON in entrambe le direzioni con corretta preservazione dei tipi.
- 04Nulla viene caricato — l'intera operazione viene eseguita localmente nel tuo browser.
Perché la formattazione YAML è importante per i file di configurazione
YAML è il linguaggio di configurazione predefinito per Kubernetes, GitHub Actions, Docker Compose, Helm charts e molti altri strumenti. È anche notoriamente sensibile all'indentazione — una singola riga con indentazione errata può produrre una mancata corrispondenza di tipo silenziosa o un errore di parsing difficile che blocca un deployment. La formattazione regolare mantiene i file coerenti e rileva i problemi prima che raggiungano la CI.
La conversione tra YAML e JSON è altrettanto utile. Alcuni strumenti accettano solo JSON per le chiamate API o le definizioni di schema, mentre gli umani generalmente preferiscono YAML per i file di configurazione di lunga durata. Essere in grado di convertire tra i due senza perdere i tipi di dati — i numeri rimangono numeri, i booleani rimangono booleani — fa risparmiare tempo e previene bug sottili.
Come formattare o convertire YAML
- 01
Incolla il tuo YAML o JSON
Incolla un manifest Kubernetes, un workflow GitHub Actions, un file Helm values, o qualsiasi altro documento YAML. Per la conversione da JSON a YAML, incolla invece JSON.
- 02
Scegli un'azione
Seleziona Formatta YAML per normalizzare l'indentazione e pulire il documento sul posto. Seleziona YAML in JSON o JSON in YAML per convertire completamente il formato.
- 03
Rivedi gli errori se presenti
Se l'input ha un errore di sintassi, lo strumento mostra il numero di riga esatto e il motivo dal parser js-yaml — lo stesso parser che i tuoi strumenti Node.js utilizzano, quindi l'errore corrisponde a quello che vedresti in produzione.
- 04
Copia l'output
Fai clic su Copia per ottenere l'output formattato o convertito. Incollalo di nuovo nel tuo file di configurazione, nel corpo di un'API, o in una definizione di schema.
Quando questo strumento ti fa risparmiare tempo
- 01Il manifest Kubernetes si è allontanato — normalizza l'indentazione prima di eseguire il commit.
- 02Il workflow GitHub Actions non riesce a fare il parsing — convalida per ottenere la riga di errore esatta.
- 03L'API accetta solo JSON ma la configurazione è archiviata come YAML — converti con un clic.
- 04Onboarding di un nuovo servizio — converti il payload di esempio JSON in YAML per la Helm chart.
- 05Copia di YAML da Stack Overflow — riformatta per corrispondere allo stile a 2 spazi del tuo progetto.
- 06Debug di un merge di valori Helm — convalida che ogni values.yaml sia individualmente pulito.
Privato, nessun caricamento richiesto
La formattazione e la conversione vengono eseguite interamente nel tuo browser utilizzando js-yaml — la stessa libreria inclusa in Webpack, Rollup e nella maggior parte degli strumenti di build JavaScript. I tuoi file di configurazione, i riferimenti ai segreti e i nomi delle variabili di ambiente non lasciano mai il tuo dispositivo.
Il parser è destinato a YAML 1.2, che è quello utilizzato da Kubernetes, GitHub Actions, Docker Compose e Helm. Se un file viene convalidato qui, verrà caricato correttamente in questi strumenti.
Domande frequenti sul formattatore YAML
La formattazione YAML preserverà i commenti?
No. Il parser js-yaml rimuove i commenti durante l'analisi — questa è una limitazione di tutti i parser YAML di JavaScript. Formatta prima, quindi aggiungi i commenti manualmente.
Quale versione di YAML supporta questo?
YAML 1.2, che è la versione utilizzata da Kubernetes, GitHub Actions, Docker Compose e Helm. Quello che viene convalidato qui verrà caricato correttamente in questi strumenti.
La conversione da YAML a JSON preserva i tipi?
Sì. I numeri, i booleani, null e le stringhe di data vengono convertiti correttamente. Un true in YAML diventa un booleano true in JSON, non la stringa 'true'.
Qual è la differenza tra formattazione e conversione?
La formattazione mantiene il file come YAML e normalizza lo spazio bianco e l'indentazione. La conversione cambia completamente il formato di output — la conversione da YAML a JSON produce un documento compatibile con .json.
Il mio YAML ha più documenti separati da ---. Verranno tutti elaborati?
Il primo documento viene analizzato e ri-emesso. Per i file multi-documento, dividi ogni sezione su --- ed elaborale singolarmente.