YAML permite expresar mapas, listas y valores con poco ruido visual, pero esa comodidad hace que la indentación y el estilo de una cadena tengan significado. Esta ruta empieza por la estructura visible y termina en las diferencias que pueden aparecer al convertir o compartir una configuración.
Qué revisar primero
Comprueba que los elementos hermanos comienzan en la misma columna, que cada
guion pertenece a la lista correcta y que un valor aparentemente textual no se
resuelve como booleano o número. Usa comillas cuando necesites fijar el tipo o
evitar que signos como # y : se interpreten como sintaxis.
Una secuencia segura
- Revisa espacios y niveles de indentación.
- Distingue mapas, listas y escalares.
- Decide si una cadena necesita comillas simples, dobles o un bloque.
- Convierte a JSON para inspeccionar la estructura resuelta.
- Compara claves, arrays y tipos con lo que esperaba la aplicación.
El conversor cubre el subconjunto YAML 1.2 documentado por la herramienta. Un archivo puede ser válido para otro procesador y usar características que no son representables directamente en JSON, como aliases o tags personalizados. La ruta explica esos límites antes de que una conversión silenciosa cambie el resultado.