Cómo funciona
El conversor de JSON a YAML transforma un objeto o un array JSON en un YAML limpio y legible, cambiando la sintaxis de llaves y corchetes por la estructura basada en indentación del YAML.
Para los archivos de configuración, el YAML suele leerse mejor que el JSON: no lleva corchetes, usa menos comillas, admite comentarios y maneja con naturalidad los textos de varias líneas. Mucha gente prefiere escribir la configuración en YAML aunque después necesite JSON para una API o para guardarlo.
Cómo se usa: pega tu JSON. El conversor genera un YAML correctamente indentado, con dos espacios por nivel. Los objetos JSON se convierten en mapas de YAML, los arrays en secuencias, los textos se entrecomillan solo cuando hace falta (si llevan caracteres especiales o si parecen otro tipo de dato) y los números y booleanos se dejan sin comillas.
Decisiones de estilo: los valores de texto se entrecomillan únicamente cuando serían ambiguos sin comillas (por ejemplo, el texto "true" se entrecomilla para que no se lea como un booleano). Los textos numéricos como "42" también se entrecomillan. El resto va sin comillas, que se lee mejor.
Textos de varias líneas: los valores largos se convierten al formato de bloque plegado de YAML (>), que los reparte en líneas legibles. Viene muy bien para meter consultas SQL, contenido en markdown o descripciones largas dentro de un archivo de configuración.
Preguntas frecuentes
- Solo cuando hace falta. Los textos se escriben sin comillas salvo que parezcan otro tipo de YAML (booleanos, números o null) o contengan caracteres especiales. Así el YAML resultante se lee mejor.
- El null de JSON se convierte en ~ (virgulilla), que es la forma compacta de escribir null en YAML. Tanto ~ como la palabra null son válidos.
- El conversor no genera comentarios, porque el JSON no tiene sintaxis de comentarios de la que partir. Puedes añadirlos a mano (# comentario) después de copiar el resultado.
- Sí. La salida sigue el formato estándar de YAML 1.2, compatible con Kubernetes, Docker Compose, GitHub Actions y el resto de herramientas que leen configuración en YAML.