Markdown.es Logo Markdown.es

¿Te es útil esta web? Apóyala sin coste: si compras en Amazon, hazlo a través de nuestro enlace de afiliado — el precio es el mismo para ti y nos ayuda a seguir.

Metadatos en Markdown: título, autor y fecha del documento

Cómo añadir metadatos a un documento Markdown con Multimarkdown: título, autor, fecha, palabras clave. Lista de campos soportados, reglas de formato y la alternativa del frontmatter YAML.

Los metadatos guardan información sobre el documento —quién lo escribe, cuándo, con qué título oficial— sin que forme parte del contenido visible. Al exportar a PDF o a un documento con formato, el procesador los usa para rellenar la portada y las propiedades del archivo.

Es una característica de Multimarkdown pensada específicamente para documentos. Si escribes para la web, salta al frontmatter YAML del final.

Sintaxis

Al principio del archivo, campo, dos puntos, valor:

Title: Guía para la utilización de Markdown
Author: Javier Cristóbal
Date: 12 de noviembre de 2015

El bloque desaparece del resultado final. Lo que hace el procesador con él depende del formato de salida: en PDF suele generar la portada y rellenar las propiedades; en HTML se convierte en etiquetas <meta>.

Cuatro reglas que hay que respetar

1. Nada por encima. Los metadatos deben ser lo primero del archivo. Un espacio o una línea en blanco antes y el bloque no se reconoce.

2. Una línea en blanco lo cierra. En cuanto haya un salto de párrafo, Multimarkdown da por terminado el bloque y lo que venga después es contenido.

3. Para valores de varias líneas, usa un salto de línea simple — dos espacios al final y Enter, no un párrafo nuevo. Es el caso típico de varios autores o una dirección postal:

Author: Javier Cristóbal  
        Otro Autor
Address: Calle Mayor 1  
         28013 Madrid

Conviene aplicar esa terminación con dos espacios a todas las líneas del bloque: evita sorpresas.

4. Los nombres de campo van en inglés. Title, no Título. Es una lista cerrada que define Multimarkdown.

Campos más útiles

Multimarkdown reconoce más de 30. Los que se usan de verdad:

CampoPara qué
TitleTítulo oficial del documento
SubtitleSubtítulo
AuthorNombre del autor o autores
DateFecha de creación
AffiliationOrganización, empresa o universidad
EmailCorreo del autor
WebURL del autor
AddressDirección postal
KeywordsPalabras clave separadas por comas
CopyrightLicencia o aviso de copyright
CommentNotas internas sobre la obra
CSSHoja de estilos a aplicar en la salida HTML
LanguageIdioma del documento

Los campos que el procesador no reconozca se ignoran sin dar error, así que puedes añadir los tuyos como notas — aunque para eso Comment es más limpio.

Compatibilidad

PlataformaMetadatos MMD
Multimarkdown
Pandoc⚠️ Prefiere YAML
Typora⚠️ Prefiere YAML
GitHub
Obsidian❌ (usa YAML)
CommonMark

⚠️ Sin soporte, el bloque se muestra como texto normal al principio del documento — precisamente el sitio donde más canta. En GitHub verás “Title: …” como primer párrafo del README.

La alternativa moderna: frontmatter YAML

El ecosistema se ha movido casi entero al frontmatter YAML: el mismo concepto, delimitado por tres guiones arriba y abajo.

---
title: "Guía para la utilización de Markdown"
author: "Javier Cristóbal"
date: 2015-11-12
tags: [markdown, guia]
draft: false
---

# El contenido empieza aquí

Ventajas sobre los metadatos de Multimarkdown:

  • Lo soporta todo lo moderno: Jekyll, Hugo, Astro, Eleventy, Obsidian, Pandoc, Zola.
  • Los delimitadores lo hacen inequívoco. No depende de que no haya una línea en blanco.
  • Admite estructuras: listas, booleanos, objetos anidados. Los metadatos de MMD solo admiten texto plano.
  • Nombres de campo libres, en el idioma que quieras.
  • Degrada mejor: donde no hay soporte, se ve un bloque delimitado que al menos parece intencionado.

Esta misma web funciona así: cada página .md empieza con un frontmatter que define su título y su descripción, y Astro los usa para generar las etiquetas <title> y <meta name="description">.

Recomendación: usa frontmatter YAML salvo que tengas una razón concreta para la sintaxis de Multimarkdown —básicamente, que tu cadena de publicación sea el propio Multimarkdown—. Es lo que espera cualquier herramienta escrita en los últimos diez años.

Pruébalo

Los metadatos existen justo para esto: acabar en un documento final. Exporta con el conversor a PDF y comprueba qué recoge de tu bloque.