Listas de definiciones en Markdown: glosarios con dos puntos

Una lista de definiciones es la estructura de un glosario: un término y su descripción debajo. En HTML son las etiquetas <dl>, <dt> y <dd>, y en Markdown llegan con Multimarkdown.

Es la forma correcta de escribir un glosario, un listado de preguntas frecuentes o cualquier par concepto-explicación. Semánticamente dice más que una lista normal con negritas.

Sintaxis

El término en una línea y la definición en la siguiente, empezando por dos puntos y un espacio:

Markdown
: Herramienta de conversión de texto plano a HTML.

Multimarkdown
: Extensión que añade tablas, notas al pie y listas de definiciones.

Resultado:

Markdown

Herramienta de conversión de texto plano a HTML.

Multimarkdown

Extensión que añade tablas, notas al pie y listas de definiciones.

La sintaxis se encarga sola de poner el término en negrita y de sangrar la definición. Tú no das formato: describes estructura.

Varias definiciones para un término

Repite la línea de dos puntos tantas veces como necesites:

Markdown
: Herramienta de conversión de texto plano a HTML.
: Lenguaje de marcado ligero que facilita escribir documentos web.
: Por extensión, el formato de archivo `.md`.

Markdown

Herramienta de conversión de texto plano a HTML.

Lenguaje de marcado ligero que facilita escribir documentos web.

Por extensión, el formato de archivo .md.

Y al revés: varios términos pueden compartir una definición si los pones en líneas consecutivas antes de los dos puntos. Útil para sinónimos.

Definiciones de varios párrafos

Deja una línea en blanco y sangra el párrafo siguiente con cuatro espacios:

Multimarkdown
: Extensión creada por Fletcher Penney en 2005.

    Nació de la necesidad de escribir documentos académicos en Markdown,
    que entonces no tenía ni tablas ni notas al pie.

Dentro de una definición funciona el resto de la sintaxis: negrita, enlaces, código y listas anidadas.

Errores frecuentes

Falta el espacio tras los dos puntos. :Definición no funciona; : Definición sí. Es el mismo tipo de error que en los encabezados.

Línea en blanco entre término y definición. Rompe la asociación: el procesador ve un párrafo suelto y una definición huérfana. Deben ir en líneas consecutivas.

Usar dos puntos al final del término. Markdown: seguido de : definición sobra — la sintaxis ya pone la separación visual.

Esperar que funcione en GitHub. No funciona. Ver compatibilidad.

Compatibilidad

Plataforma	Listas de definiciones
Multimarkdown	✅
Pandoc	✅
Python-Markdown (extensión def_list)	✅
Typora	✅
Kramdown (Jekyll)	✅
GitHub	❌
Obsidian	❌ (con plugin)
CommonMark	❌

⚠️ Sin soporte degrada mal: verás los dos puntos literales al principio de cada línea, como si fuera un error de tecleo.

Alternativas cuando no hay soporte

HTML en línea — portable y explícito:

<dl>
  <dt>Markdown</dt>
  <dd>Lenguaje de marcado ligero.</dd>
</dl>

Una lista normal con negrita — lo que hace todo el mundo en GitHub:

- **Markdown** — lenguaje de marcado ligero.
- **Multimarkdown** — extensión con tablas y notas al pie.

Visualmente casi idéntico y funciona en todas partes. Pierdes la semántica de <dl>, que importa para lectores de pantalla y para que un buscador entienda que es un glosario, pero para la mayoría de casos es un intercambio razonable.

Una tabla de dos columnas — si las definiciones son cortas y quieres una rejilla clara, una tabla con “Término” y “Significado” funciona bien y sí es compatible con GFM.

Cuándo merece la pena

Usa listas de definiciones cuando la relación término-descripción sea el punto de la lista: glosarios, referencias de parámetros, preguntas frecuentes. Para una enumeración corriente, una lista normal es lo correcto.

Si escribes para la web y controlas el CSS, la etiqueta <dl> además te permite estilar términos y definiciones por separado sin tocar el texto.

Pruébalo

Los dos puntos y el espacio son quisquillosos. Pega tu glosario en el previsualizador de Markdown para confirmar que se procesa antes de publicarlo.