El Frontmatter en Obsidian

El frontmatter es un bloque de metadatos (información sobre el propio documento) que se coloca en la parte superior absoluta de un archivo Markdown. En Obsidian, este bloque se escribe en formato YAML y queda delimitado por tres guiones (---) al principio y al final. Obsidian interpreta automáticamente este bloque y lo transforma en una interfaz visual interactiva llamada Propiedades (Properties).

El Sistema Propiedad / Valor

El frontmatter funciona bajo una estructura de clave-valor (propiedad: valor).

• Propiedad (o Clave): Es el nombre del campo o la etiqueta que define qué tipo de información estás guardando (por ejemplo, tipo, fecha, estado).
• Valor: Es el dato real asignado a esa propiedad. Puede ser un texto, un número, una fecha, un valor booleano (verdadero/falso) o una lista.

Tipos de valores comunes en Obsidian:

• Texto (Texto plano): slug: frontmatter
• Booleano (True/False): draft: false
• Listas (Arrays): Se estructuran con guiones abajo de la propiedad.
• Fecha/Hora (ISO 8601): 2026-06-16T18:40:10.000Z

Desglose de Propiedades y Valores (en MarkeUp)

A continuación se explica el significado y los posibles valores de cada propiedad incluida en tu bloque de metadatos:

1. Identificación y SEO

• Title (Texto): El título formal del artículo. Ejemplo: “Qué es el frontmatter?”.
• slug (Texto): La parte final de la URL amigable para web. Ejemplo: frontmatter.
• description (Texto): Resumen breve del post para motores de búsqueda o previsualizaciones.
• canonicalUrl (Texto/URL): URL original si el contenido es un duplicado. Vacío ("") significa que este artículo es la fuente original.

2. Configuración del Post

• type (Texto): Define el tipo de contenido. Posibles valores: post, page, tutorial, snippet.
• lang (Texto/Código de idioma): El idioma del documento. Ejemplo: es-ES (Español de España), en-US.
• draft (Booleano): Indica si el artículo es un borrador.
  • false: Está listo para publicar.
  • true: Sigue en edición.

3. Autoría y Fechas

• authors (Lista): Lista de los creadores del contenido. Ejemplo: - Admin. Puede incluir más nombres abajo.
• pubDate (Fecha y Hora): Fecha de publicación en formato global UTC.
• updatedDate (Fecha y Hora): Última vez que se modificó el archivo.

4. Clasificación (Taxonomía)

• categories (Lista): Categoría principal del post. Ejemplo: - documentacion.
• tags (Lista): Etiquetas clave para agrupar y buscar contenido. Ejemplos: - obsidian, - configuracion. En Obsidian, estas se integran directamente con el sistema de #tags.

5. Estética y Visualización

• featured (Booleano): Define si el post destaca en la página principal o slider. (true / false).
• image (Texto/Ruta): Ruta de la imagen de portada. Ejemplo: /img/untitled.webp.
• imageAlt (Texto): Texto alternativo de la imagen para accesibilidad y SEO.

6. Interactividad y Permisos

• allowComments (Booleano): Activa o desactiva la caja de comentarios. (true / false).
• share (Booleano): Permite o bloquea los botones para compartir en redes sociales. (true / false).

7. Comportamiento en Obsidian y Web

• aliases (Lista): Nombres alternativos para esta nota dentro de Obsidian. Permite hacer enlaces internos (Frontmatter) usando sinónimos.
• noIndex (Booleano): Le dice a Google si debe indexar la página o no.
  • false: Permite que aparezca en buscadores.
  • true: Oculta la página de Google.
• hideTOC / showTOC (Booleano): Controla si se oculta o se muestra la Tabla de Contenidos (Table of Contents).
• hideCoverImage (Booleano): Oculta la imagen de portada en la parte superior del post si se pone en true.