Perché si converte soprattutto in una direzione
Molte API restituiscono JSON, ma l'ecosistema infrastrutturale scrive YAML: Kubernetes, Compose, Actions, Ansible. Riscrivere a mano è noioso e favorisce gli errori di indentazione, cioè proprio il difetto che YAML punisce con più severità.
Ogni JSON è YAML valido, ma non viceversa
La specifica YAML 1.2 è un soprainsieme di JSON, quindi qualunque JSON valido è già YAML valido. La conversione non altera i dati: riscrive la sintassi nella forma indentata, più leggibile e assai più diffusa nei file di configurazione.
Attenzione a ciò che YAML deduce da solo
Passando a YAML spariscono le virgolette, così stringhe come `yes`, `no` oppure `1.10` possono essere reinterpretate come booleano o numero alla rilettura. Se un valore deve restare testo, controllalo dopo la conversione e mettilo tra virgolette.