Tema

YAML sin errores de estructura ni tipos

Entiende la indentación, las listas, las comillas y los escalares YAML antes de convertirlos o usarlos como configuración.

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

  1. Revisa espacios y niveles de indentación.
  2. Distingue mapas, listas y escalares.
  3. Decide si una cadena necesita comillas simples, dobles o un bloque.
  4. Convierte a JSON para inspeccionar la estructura resuelta.
  5. 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.

Herramientas

Herramientas para este tema

Guías

Guías en orden recomendado

  1. Indentación YAML: espacios, tabuladores y errores frecuentesAprende cómo funciona la sangría en YAML, por qué los tabs no sirven para indentar y cómo localizar un nivel incorrecto.
  2. Cómo escribir listas y objetos en YAML sin equivocarse de nivelAprende a combinar secuencias y mapas YAML, alinear guiones y comprobar la estructura equivalente en JSON.
  3. Comillas en YAML: simples, dobles o texto sin comillasAprende cuándo usar comillas simples, dobles o escalares simples en YAML y cómo cambian escapes, comentarios y tipos.
  4. Booleanos en YAML: por qué yes, no, on y off cambian según la versiónEvita que palabras como yes, no, on y off cambien de cadena a booleano al mover YAML entre analizadores y versiones.
  5. Cadenas multilínea en YAML: diferencias entre | y >Entiende los bloques literal y plegado de YAML, los indicadores de chomping y cómo conservar o unir saltos de línea.
  6. Anchors, aliases y merge keys en YAMLEntiende cómo reutiliza nodos YAML, por qué JSON no conserva referencias y qué revisar antes de convertir un archivo con merges.
  7. Cómo convertir YAML a JSON sin sorpresasIdentifica el subconjunto compatible, conserva tipos y detecta comentarios, anchors, tags o claves que JSON no puede representar.
  8. Cómo convertir JSON a YAML sin perder tiposAprende a convertir JSON a YAML conservando cadenas, números, booleanos y null, con ejemplos verificables y límites de compatibilidad.
  9. JSON vs YAML: diferencias y cuándo usar cada formatoCompara sintaxis, tipos, comentarios, referencias e interoperabilidad para elegir JSON o YAML según el trabajo.

Revisado el por Tools in a Tab.