Estructuras básicas en YAML

En YAML los datos se organizan principalmente mediante listas y diccionarios (también llamados mapas u objetos). Estas estructuras permiten modelar información compleja de forma legible.

5.1 Listas (arrays)

Una lista es una colección ordenada en la que cada elemento comienza con un guion (-) precedido por un espacio.

Lista simple de frutas:

frutas:
  - Manzana
  - Banana
  - Naranja

Equivalente en JSON:

{
  "frutas": ["Manzana", "Banana", "Naranja"]
}

Lista de números:

numeros:
  - 10
  - 20
  - 30

Lista multilínea:

lenguajes:
  - Python
  - Java
  - JavaScript
  - Go
Tip: toda línea de lista usa un guion seguido de un espacio. La indentación debe ser uniforme para evitar errores.

5.2 Diccionarios (maps)

Un diccionario agrupa pares clave-valor. La clave se escribe seguida de dos puntos (:) y el valor a continuación, respetando la indentación.

Diccionario simple:

producto:
  codigo: 1
  descripcion: Teclado
  precio: 15000

Equivalente en JSON:

{
  "producto": {
    "codigo": 1,
    "descripcion": "Teclado",
    "precio": 15000
  }
}

Diccionario anidado:

usuario:
  nombre: Juan
  edad: 30
  direccion:
    calle: San Martín
    numero: 1234
    ciudad: Córdoba
Recuerda: cada nivel anidado se representa con dos espacios adicionales para mantener la jerarquía visual.

5.3 Combinación de listas y diccionarios

Las estructuras reales combinan listas y diccionarios para expresar relaciones más ricas.

Lista de diccionarios:

productos:
  - codigo: 1
    descripcion: Teclado
    precio: 15000
  - codigo: 2
    descripcion: Mouse
    precio: 9000
  - codigo: 3
    descripcion: Monitor
    precio: 85000

Diccionario con listas:

persona:
  nombre: Laura
  hobbies:
    - Leer
    - Correr
    - Programar

Lista de diccionarios anidados:

usuarios:
  - nombre: Ana
    edad: 25
    habilidades:
      - Python
      - Django
  - nombre: Marcos
    edad: 32
    habilidades:
      - Java
      - Spring Boot

5.4 Buenas prácticas

  • Para listas, usa guiones con un espacio y alinea los elementos en el mismo nivel.
  • En diccionarios, mantén las claves en minúsculas y consistentes (nombre, precio, codigo).
  • En estructuras mixtas, respeta la indentación para que YAML pueda interpretar la jerarquía.
  • Usa listas de diccionarios para colecciones de objetos similares (productos, usuarios).
  • Utiliza diccionarios con listas cuando una clave agrupa múltiples valores (hobbies, habilidades).

Con listas, diccionarios y sus combinaciones puedes modelar desde datos simples hasta configuraciones complejas de forma clara y mantenible.