Frontmatter en Obsidian: propiedades YAML y campos de MarkeUP

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. Este sistema de metadatos es el que impulsa las taxonomías de un blog estático como el Vault CMS construido con Astro, donde cada propiedad alimenta los índices de categorías y etiquetas. Obsidian interpreta automáticamente este bloque y lo transforma en una interfaz visual interactiva llamada Propiedades (Properties). Si quieres ver el estándar completo de campos (concept, title, slug, tags, image, canonicalUrl), revísalo en la documentación de arquitectura y en la guía de Vault CMS.

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

• concept (Texto): La etiqueta CORTA del artículo (1-4 palabras). Es la que se ve: titular del post, tarjetas de los listados, grafo y tooltips. Ejemplo: “El Aura”.
• title (Texto): El título LARGO con valor SEO (50-75 caracteres recomendado; fuera de 40-90 el gate solo avisa). No se muestra en pantalla: es el que aparece en Google, en la pestaña del navegador y al compartir el enlace. Arranca por la palabra clave del concept y no lleva | MarkeUP (lo añade la plantilla). Ejemplo: “Aura: capas del campo sutil, vibración y equilibrio energético”.
• slug (Texto): La parte final de la URL amigable para web. Se deriva del concept, no del título SEO. Ejemplo: el-aura.
• description (Texto): Resumen para motores de búsqueda y previsualizaciones. 140-200 caracteres (recomendado; ≥12 palabras; fuera de 100-260 el gate solo avisa), con la palabra clave en los primeros 155 caracteres.
• 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. Debe ser una de las 5 válidas (Humano, Documentación, Literatura, Opinión, Máquina) y coincidir con la carpeta que contiene la nota. Ejemplo: - Humano.
• 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 (Booleano): Controla si se oculta la Tabla de Contenidos (Table of Contents). Es el campo vigente. ⚠️ showTOC es legado (el schema de Astro aún lo lee, pero no lo uses en notas nuevas).
• hideCoverImage (Booleano): Oculta la imagen de portada en la parte superior del post si se pone en true.

8. Obra citada (campo condicional)

• bookIsbn (Texto): El ISBN del libro del que habla la nota, entre comillas (Ejemplo: “9788413628875”). No es uno de los 22 campos: solo lo llevan las notas que reseñan o citan una obra, y su ausencia no es deuda de calidad. Con él, el build pinta una tarjeta con la portada, la autoría, la editorial, el año, la nota media con su atribución, la sinopsis y el enlace a la ficha, y emite el Book de schema.org. La tarjeta se coloca antes del índice (el lector sabe de qué libro se habla antes de bajar), toda ella es un enlace a la ficha y su ficha técnica (editorial, fecha, ISBN, páginas…) se despliega dentro. La nota media solo aparece si la fuente la trae: la publica Google Books y su cuota anónima responde 429, así que sin clave propia (~/.config/markeup/google-books.env, fuera del repo) la ficha se rellena con el feed de volúmenes de Google Books —que tampoco pide clave y trae la sinopsis editorial española— y con Open Library para la editorial, las páginas y la portada: fichas en español y sin estrellas. Si el ISBN no tiene ficha en la caché (scripts/data/books.json, que se rellena con npm run books:fetch), el post se publica igual: simplemente se queda sin tarjeta. Lo validan npm run validate:frontmatter (tipo y forma) y npm run validate:books (checksum y ficha ↔ post).

Aplicación: este esquema es el que permite a proyectos como el Vault CMS generar listados, categorías y etiquetas a partir de cada nota, y el que sostiene la paridad editorial con una bóveda de Obsidian.

En conjunto, esta guía cubre el ciclo completo de un post: creación, edición y publicación en un sitio de Astro gestionado con la guía de Vault CMS.

En esta misma línea, NPM: El Administrador de Paquetes para Node.js aborda nPM, el gestor de paquetes de Node.js: qué es, la estructura y los campos de package.json, los scripts de desarrollo, el.