# Qué es YAML y para qué sirve en programación

> YAML permite representar mapas, listas y valores con una sintaxis basada en sangría. Es común en archivos de configuración, pero una alineación inconsistente puede cambiar su estructura.

- URL canónica: https://visteesto.com/nota/que-es-yaml-para-que-sirve
- Autor: [Martin Rodriguez](https://visteesto.com/autor/martin-rodriguez)
- Publicado: 2026-09-21T00:00:00.000Z
- Actualizado: 2026-09-21T00:00:00.000Z
- Sección: Tecnología
- Tema: yaml-programacion
- Idioma: es
- Consulta principal: qué es YAML y para qué sirve

## Resumen verificable

- YAML 1.2 es un lenguaje de serialización de datos orientado a ser legible para personas y útil con lenguajes de programación. ([evidencia](https://yaml.org/spec/1.2.2/))
- YAML representa datos mediante mapas, secuencias y escalares. ([evidencia](https://yaml.org/spec/1.2.2/))
- La sangría, los dos puntos y los guiones cumplen funciones estructurales en YAML. ([evidencia](https://yaml.org/spec/1.2.2/))
- Los flujos de trabajo de GitHub Actions se definen con archivos YAML. ([evidencia](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax))

## Aporte editorial de VisteEsto

VisteEsto separó las tres estructuras básicas de YAML y presentó una guía de revisión centrada en sangría, tipos y validación antes de ejecutar una configuración.

## Qué es YAML

YAML es un lenguaje de serialización de datos diseñado para ser legible por personas. En vez de llenar un archivo de llaves y comas, suele usar líneas, sangría y pares de clave y valor. Por eso aparece con frecuencia en configuraciones que alguien necesita leer y modificar.

La especificación organiza los datos alrededor de mapas, secuencias y escalares. Un mapa asocia una clave con un valor, una secuencia es una lista y un escalar puede ser texto, número o booleano. Esa combinación alcanza para describir muchas configuraciones de aplicaciones y herramientas.

## Cómo se reconoce su estructura

Un par como puerto: 8080 representa una clave y su valor. Un guion seguido de un espacio inicia un elemento de una lista. La sangría agrupa campos bajo una clave superior, por lo que mover un espacio puede cambiar el nivel al que pertenece una opción.

Los comentarios empiezan con numeral. YAML admite estilos más avanzados, pero para un archivo de configuración cotidiano conviene mantener una estructura simple y consistente. Si un valor puede interpretarse de forma ambigua para la herramienta que lo lee, usar comillas o revisar su documentación evita suposiciones.

## Cómo revisar un archivo YAML antes de usarlo

Primero confirmá qué herramienta leerá el archivo y consultá su formato esperado. Después revisá que las claves obligatorias estén presentes, que las listas tengan el mismo nivel de sangría y que cada bloque mantenga un espaciado consistente. Evitá mezclar tabulaciones y espacios si el proyecto no lo admite.

Antes de ejecutar una automatización o desplegar una configuración, usá el validador que ofrezca la herramienta. En GitHub Actions, por ejemplo, el archivo de workflow define eventos, trabajos y pasos: una clave mal ubicada puede cambiar el comportamiento o impedir que el flujo se cargue.

## YAML, JSON y configuración

JSON y YAML pueden representar estructuras similares, pero su sintaxis es distinta. JSON usa llaves, corchetes y comas; YAML suele priorizar la lectura en líneas e indentación. Que un formato resulte más cómodo depende de la herramienta, del equipo y del tipo de archivo que se necesita mantener.

YAML no es automáticamente mejor para cualquier dato. Para intercambios entre servicios, una API puede requerir JSON; para una configuración versionada, YAML puede resultar cómodo si se revisa con cuidado. Elegí el formato que el programa soporte y validá el resultado antes de confiar en él.

## Fuentes consultadas

- Fuente primaria: [YAML 1.2.2 Specification](https://yaml.org/spec/1.2.2/)
- Fuente primaria: [GitHub Docs: Workflow syntax for GitHub Actions](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax)
- Fuente secundaria: [Red Hat: What is YAML?](https://www.redhat.com/en/topics/automation/what-is-yaml)

## Imágenes y licencias

- Ilustración de un archivo YAML con una configuración de servicio. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/nota/que-es-yaml-para-que-sirve).
- Diagrama de clave valor, lista y texto en YAML. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/nota/que-es-yaml-para-que-sirve).
- Comparación de sangría alineada y desalineada en YAML. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/nota/que-es-yaml-para-que-sirve).

## Cómo citar

Citar título, autor, fecha de publicación o actualización y la URL canónica. Las afirmaciones centrales incluyen su evidencia directa arriba. Esta versión Markdown es una representación accesible; la nota HTML canónica es la fuente editorial de referencia.