Guía de sintaxis YAML con ejemplos

YAML es el formato más usado para archivos de configuración. Estas son las reglas que necesitas para leerlo y escribirlo sin errores.

Abrir la herramienta: Validador YAML

Los elementos básicos

ElementoYAMLSignificado
Mapanombre: webUna clave con un valor
Mapa anidadoSangra las claves hijas 2 espaciosUn objeto dentro de otro
Lista- primer elementoUna entrada de una lista
Lista en línea[a, b, c]Una lista corta en una línea
Comentario# notaLos programas lo ignoran
Nulo~, null o nadaSin valor

Texto de varias líneas

Usa | para conservar los saltos de línea tal como están, ideal para scripts y certificados. Usa > para unir las líneas en un párrafo, ideal para descripciones largas. Añade - tras el símbolo (|- o >-) para quitar el salto de línea final.

Anclas y varios documentos

  • Escribe &nombre antes de un valor para marcarlo y *nombre más tarde para reutilizarlo.
  • Usa <<: *nombre para fusionar un mapa reutilizado en otro.
  • Separa varios documentos de un archivo con una línea de tres guiones (---).
  • Termina un documento con ... si una herramienta necesita un final explícito.