Las claves verificadas
- YAML 1.2 es un lenguaje de serialización de datos orientado a ser legible para personas y útil con lenguajes de programación. Ver evidencia
- YAML representa datos mediante mapas, secuencias y escalares. Ver evidencia
- La sangría, los dos puntos y los guiones cumplen funciones estructurales en YAML. Ver evidencia
- Los flujos de trabajo de GitHub Actions se definen con archivos YAML. Ver evidencia
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.
También puede servirte: Qué es un webhook y en qué se diferencia de una API
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.
Qué aporta VisteEsto: Nuestro trabajo en esta nota
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.
Fuentes, actualizaciones y metodología 3 fuentes
Fuentes consultadas
- Fuente primariaYAML 1.2.2 Specification
- Fuente primariaGitHub Docs: Workflow syntax for GitHub Actions
- Fuente secundariaRed Hat: What is YAML?
Historial de actualización
- Publicación inicial con fuentes técnicas verificadas, diagramas editoriales originales y revisión factual.
Cómo elaboramos esta nota
Definimos la consulta principal “qué es YAML y para qué sirve”, contrastamos los datos con 3 fuentes —2 primarias— y revisamos contexto, imágenes y posibles vacíos antes de publicar. Conocé nuestra política editorial y de verificación.
