01Qué es y cómo funciona
YAML (YAML Ain't Markup Language) utiliza sangría y pares clave-valor para representar datos anidados. En SEO, aparece como front matter en la parte superior de los archivos Markdown o HTML en generadores de sitios estáticos como Jekyll, Hugo o Eleventy. El front matter se analiza en el momento de la compilación para generar meta tags de HTML, como ` y `. Los motores de búsqueda nunca ven el YAML en sí; ven el HTML renderizado. El formato es estricto con los espacios y la estructura, por lo que un pequeño error puede romper toda la compilación o eliminar silenciosamente los metadatos.
YAML es una forma de escribir datos con sangría y pares clave-valor, utilizada para establecer títulos, descripciones y otros campos de SEO en las páginas.
02Qué hacer al respecto
Añade front matter en YAML a cada página de tu sitio estático. Incluye al menos los campos title, description y canonical. Usa los mismos nombres de clave en todas las páginas para mantener la consistencia. Valida tu YAML con un linter antes de compilar el sitio. Si utilizas un CMS que genera YAML, comprueba que el HTML resultante contenga las meta etiquetas esperadas. Para sitios dinámicos, normalmente no es necesario el YAML; utiliza una base de datos o JSON en su lugar.
03Cómo se mide o se detecta
Puedes detectar problemas de YAML inspeccionando el HTML renderizado de tus páginas. Busca las etiquetas ` y `; si faltan o son incorrectas, es probable que el front matter sea erróneo. Utiliza Google Search Console para ver si Google muestra los títulos y descripciones que has previsto. Un rastreador de sitios como Screaming Frog también puede informar de meta etiquetas faltantes o duplicadas, que a menudo se deben a problemas en el front matter. También puedes revisar el registro de compilación (build log) en busca de errores de análisis de YAML.
04Errores comunes
- Usar tabulaciones para la sangría en lugar de espacios: YAML requiere espacios.
- Olvidar poner entre comillas las cadenas que contienen dos puntos, como "Title: A Guide".
- Escribir datos estructurados en YAML en lugar de JSON-LD: los motores de búsqueda no analizan YAML.
- Omitir la validación: un solo error tipográfico puede romper toda la compilación.
- Repetir la misma clave en un mismo bloque, lo cual no es válido en YAML.
05Límites
YAML es una herramienta de tiempo de compilación (build-time), no un formato de tiempo de ejecución (runtime). Los motores de búsqueda no leen YAML directamente, por lo que no puede reemplazar los datos estructurados como JSON-LD. Solo se aplica a generadores de sitios estáticos o pipelines de compilación; los sitios dinámicos que renderizan páginas desde una base de datos no tienen uso para YAML. A menudo se confunde YAML con JSON porque ambos son formatos de datos, pero YAML es más legible para los humanos y admite comentarios, mientras que JSON es un subconjunto estricto y es el estándar para datos estructurados. YAML también tiene casos límite con caracteres especiales que pueden causar fallos silenciosos.
06Ejemplo práctico
---
title: "How to Use YAML for SEO"
description: "A practical guide to YAML front matter."
canonical: "https://example.com/yaml-seo"
robots: "index, follow"
---
La entrada anterior está escrita por GetLoopLoop. Lo que sigue es lo que los catálogos independientes recogen sobre el mismo término; nada de ello es la fuente de esta página.
- También llamado
- YAML Ain't Markup Language, Yet Another Markup Language, .yaml, .yml
- Introducido
- 2001
- Desarrollado por
- Clark Evans
- Se basa en
- Extensible Markup Language, Perl, JavaScript Object Notation
- Tipo de cosa
- formato de archivo, lenguaje de marcado, formato de serialización de datos
El mismo término en Wikipedia
Catalogado en 26 idiomas07Preguntas frecuentes
¿En qué se diferencia YAML de JSON?
YAML es más legible para los humanos y utiliza la sangría en lugar de corchetes y comas, mientras que JSON es un subconjunto estricto de YAML. Para el front matter, YAML es el estándar en la mayoría de los generadores de sitios estáticos porque es más fácil de escribir y leer.
¿Es necesario el front matter de YAML para mi sitio estático?
No, es opcional pero recomendado. La mayoría de los generadores de sitios estáticos utilizan el front matter de YAML para establecer metadatos como el título, la descripción y el diseño (layout). Sin él, te perderás funciones de SEO y de datos estructurados.
¿Cómo escribo correctamente el front matter de YAML?
Colócalo entre tres guiones al principio de tu archivo y luego usa pares clave-valor con una sangría constante. Usa espacios, no tabulaciones, y pon entre comillas las cadenas que contengan caracteres especiales como dos puntos o almohadillas.
¿Sigue funcionando YAML con los generadores de sitios estáticos modernos?
Sí, YAML sigue siendo el estándar para el front matter en Jekyll, Hugo y Eleventy. Cuenta con un gran soporte e incluso herramientas más nuevas como Astro lo aceptan. Puedes confiar en él para los metadatos de tu sitio.
¿Qué falla si mi YAML tiene un error de sintaxis?
Es posible que el sitio no se pueda compilar, o que las páginas muestren títulos y descripciones predeterminados en lugar de los personalizados. Lo notarás al inspeccionar el HTML renderizado y ver que faltan las meta tags. El sistema de compilación suele indicar la línea exacta.
08Preguntado en voz alta
El mismo término en las palabras que alguien usa al hablar con un asistente en lugar de escribir en un buscador: escrito desde la situación, y por eso cada pregunta lleva la situación de la que salió.
Probablemente sea tu YAML front matter. Abre el archivo markdown de la página y busca el campo "title" entre los guiones. Corrígelo y vuelve a compilar el sitio.
Eso es el YAML front matter. Contiene los metadatos de la página, como el título, la descripción y el layout. Puedes editarlo directamente y el sitio se actualizará cuando vuelvas a compilar.
Es probable que hayas olvidado añadir una descripción en el YAML front matter. Revisa la parte superior de cada archivo de página y añade un campo de descripción. Vuelve a compilar y a desplegar.