Vai al contenuto principale
Bethemesh
Sviluppo

Formattatore YAML

Reindenta YAML, normalizzane la presentazione e rileva i problemi strutturali più comuni direttamente nel browser.

  • Appunti
  • Esporta
Automatizza

Integra questo widget

Personalizza il risultato, controlla l’anteprima e copia il codice.

Anteprima

Tipo di codice di integrazione

Codice da copiare

Responsive e ridimensionato automaticamente da Bethemesh.

Questo strumento ti è stato utile?

Come funziona questo strumento?

Rientra un documento YAML senza convertirlo in JSON. Il formattatore analizza la struttura prima di riscriverla, distinguendo mapping, liste e testo isolato. Conserva la rappresentazione documentale di commenti, ancore e valori multilinea invece di ricostruire soltanto i valori risolti. È utile per configurazioni versionate o estratti da condividere con un gruppo di lavoro. Il file rimane nel browser; il trattamento non consulta repository remoti né servizi di distribuzione.

Il parser usa YAML 1.2 per impostazione predefinita e rispetta le direttive di versione supportate. Dopo il riconoscimento applica il rientro scelto, con almeno due spazi. Liste e mapping sono identificati sintatticamente: sostituire spazi su ogni riga potrebbe alterare il contenuto di una stringa letterale.

Chiavi duplicate nello stesso mapping, sintassi non valida e documenti multipli sono rifiutati. Le tabulazioni non possono rientrare la struttura YAML, ma possono appartenere a un valore secondo la relativa sintassi. Uno scalare come not yaml è valido: YAML non si limita alle coppie chiave-valore.

La formattazione opera sul documento YAML senza espandere gli alias in oggetti JSON. Ancore e commenti possono quindi rimanere rappresentati. Gli interi grandi mantengono la scrittura senza diventare numeri JavaScript arrotondati. Spazi di presentazione, virgolette e spazi nelle collezioni compatte possono essere normalizzati; l’output non è una copia identica byte per byte.

Il successo indica che questo parser legge il documento, non che l’applicazione ne accetti i parametri. Non carica file indicati nei percorsi e non interpreta tag personalizzati secondo regole applicative. Lettori YAML precedenti possono applicare regole di tipo diverse: verifica la versione attesa dal tuo ambiente.

Come usare questo strumento

  1. Importa un documento YAML

    Incolla il testo completo con i commenti. Se il file contiene più documenti separati da ---, elaborali individualmente.

  2. Scegli il rientro e formatta

    Seleziona una larghezza proposta. In caso di errore cerca mapping non chiusi, chiavi duplicate o rientri strutturali non validi.

  3. Rileggi e recupera il file

    Confronta valori multilinea e commenti prima di copiare o scaricare YAML. Modificare sorgente o rientro nasconde il risultato precedente.

Casi d’uso

Rivedere una configurazione prima del commit

Uniforma i rientri per controllare livelli e commenti. La presentazione non conferma nomi dei parametri né validità per il programma di destinazione.

Conservare una configurazione documentata

Preferisci la formattazione a un passaggio di andata e ritorno tramite JSON quando commenti e nomi delle ancore spiegano il file.

Distinguere sintassi e contratto dei dati

Verifica prima che YAML sia leggibile, poi controlla separatamente i requisiti applicativi con gli strumenti del progetto.

Esempi

Normalizzare un rientro valido

Tre spazi costituiscono un rientro valido in questo caso. La larghezza predefinita di due spazi riallinea child e mantiene il commento note.

Input

# note
root:
   child: 1

Risultato

# note
root:
  child: 1

Mantenere una lista compatta

Il parser riconosce items come lista e active come booleano. La notazione compatta rimane una lista; si normalizzano solo gli spazi di presentazione.

Input

items: [a, b]
active: true

Risultato

items: [ a, b ]
active: true

Consigli e buone pratiche

  • Non sostituire globalmente gli spazi in YAML: possono appartenere a un blocco di testo il cui valore preciso è importante.
  • Metti tra virgolette stringhe simili a date o booleani quando lettori YAML diversi possono interpretare lo stesso file.
  • Usa il convertitore JSON/YAML per ottenere JSON: applica controlli aggiuntivi sui valori rappresentabili nel relativo modello.
  • Conserva direttive e commenti utili nella sorgente e rivedi le differenze prima di sostituire configurazioni condivise.

Fonti e riferimenti

Domande frequenti

Perché un semplice testo è accettato come YAML?

YAML permette uno scalare alla radice. not yaml è una stringa valida anche quando una particolare applicazione richiede un oggetto di configurazione. Sintassi del formato e contratto applicativo sono controlli distinti.

La formattazione elimina commenti e ancore?

Il motore conserva la loro rappresentazione nel documento YAML invece di passare tramite JSON. La disposizione può cambiare, ma non vengono scartati deliberatamente come in un formato senza commenti.

La validazione garantisce una configurazione Kubernetes corretta?

No. Il parser verifica YAML senza conoscere risorse, versioni API o vincoli del cluster. Usa successivamente le validazioni disponibili nel tuo ambiente Kubernetes.

Perché le chiavi duplicate sono rifiutate?

Lettori diversi possono interpretare nomi ripetuti in modo differente. Il rifiuto invita a scegliere esplicitamente valore e struttura desiderati, senza perdere silenziosamente un’occorrenza.

Strumenti correlati

Continua con questi strumenti

Strumenti simili o complementari a questo.

Strumenti simili

Formattatore JSON

Formatta, minifica e valida un documento JSON per renderlo più leggibile o compatto.

SviluppoIn evidenzaUsa questo strumento