Cuándo conviene
Muchas herramientas aceptan ambos formatos, pero los archivos de configuración suelen escribirse en YAML porque se lee mejor y admite comentarios. Una respuesta de API o una configuración generada en JSON se convierte así en un archivo que puedes editar a mano.
Cómo se escriben los valores
Números y booleanos van sin comillas. Las cadenas «true», «false», «null», «yes» y «no» llevan comillas, porque un lector YAML 1.1 las convertiría en booleanos. Las cadenas con dos puntos, almohadilla o espacios iniciales se escriben entre comillas dobles, algo válido en YAML. Los objetos y arrays vacíos pasan a {} y [].
Límites
JSON no tiene comentarios, así que no aparecen en el resultado. Los textos de varias líneas se escriben en una línea con \n. Comprueba siempre el resultado con tu propia herramienta antes de desplegar.
Ejemplo
JSON anidado convertido a YAML con sangría de dos espacios.
Entrada
{"name":"Ada","skills":["math","code"],"address":{"city":"London"}}Resultado
name: Ada skills: - math - code address: city: London
