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.

Notas al pie en Markdown: sintaxis y compatibilidad

Cómo crear notas al pie de página en Markdown con la sintaxis de acento circunflejo. Numeración automática, enlace de ida y vuelta, notas de varios párrafos y en qué plataformas funcionan.

Las notas al pie permiten apartar una aclaración, una fuente o un matiz sin cortar la lectura del texto principal. Son imprescindibles en documentos académicos y muy útiles en artículos largos.

No están en el Markdown original: llegaron con Multimarkdown y hoy las admiten muchos procesadores, aunque no todos.

Sintaxis

Dos partes: la marca dentro del texto y la definición en cualquier otro punto del documento. Ambas usan un identificador entre corchetes precedido de un acento circunflejo ^.

Markdown fue creado en 2004[^origen].

[^origen]: Por John Gruber, con la colaboración de Aaron Swartz.

Resultado:

Markdown fue creado en 20041.

Al procesarse ocurren cuatro cosas automáticamente:

  1. La marca se convierte en un número volado y clicable.
  2. La definición se mueve al final del documento, separada por una línea horizontal.
  3. Se numeran en orden de aparición, no en el orden en que las definas.
  4. Se genera un enlace de vuelta (↩) para regresar al punto de lectura.

Esa cuarta es la que las hace realmente cómodas: el lector va, lee la nota y vuelve exactamente donde estaba.

El identificador es una etiqueta, no un número

Escribir [^1], [^2], [^3] funciona, pero es una mala idea: en cuanto insertes una nota en medio tendrás que renumerarlas todas a mano.

Usa nombres descriptivos:

Según el estudio[^estudio-2024], la adopción creció un 40 %.
Aunque otras fuentes[^discrepancia] lo matizan.

[^estudio-2024]: Informe anual de uso de formatos de texto, 2024.
[^discrepancia]: La metodología del informe solo cuenta repositorios públicos.

El identificador no aparece en el resultado final — el lector solo ve 1 y 2. Es únicamente para ti, así que optimízalo para tu comodidad al editar. No admite espacios.

Dónde poner las definiciones

Pueden ir en cualquier punto del documento: justo debajo del párrafo, al final de la sección o todas juntas al final del archivo. El resultado renderizado es idéntico — siempre acaban abajo.

Dos escuelas:

  • Junto al párrafo — más cómodo al escribir, ves la nota mientras redactas.
  • Todas al final — el texto principal queda más limpio de leer en crudo.

Igual que con los enlaces de referencia, es cuestión de preferencia. Sé consistente dentro de un mismo documento.

Notas de varios párrafos

Para que una nota contenga más de un párrafo, sangra las líneas siguientes con cuatro espacios:

Un tema que da para mucho[^larga].

[^larga]: Primer párrafo de la nota.

    Segundo párrafo, sangrado cuatro espacios para que
    siga formando parte de la misma nota.

Dentro de una nota puedes usar el resto de sintaxis: negrita, enlaces, código e incluso listas, siempre respetando la sangría.

Notas en línea

Algunos procesadores (Pandoc entre ellos) admiten definir la nota en el sitio, sin identificador:

Markdown es de 2004.^[Creado por John Gruber.]

Es cómodo para notas cortas, pero no es portable: en GitHub y en la mayoría de sitios verás el texto literal con el circunflejo y los corchetes. Úsalo solo si controlas el procesador.

Compatibilidad

PlataformaNotas al pie
GitHub
Obsidian
Pandoc
Typora
VS Code (vista previa)⚠️ Requiere extensión
Notion
Discord / Reddit
Markdown original
CommonMark

⚠️ Degradan mal. A diferencia del tachado, que sin soporte se ve como ~~texto~~ y se entiende, una nota al pie sin soporte deja [^origen] en mitad de la frase y una línea suelta al final que parece un error. Si escribes para una plataforma que no las admite, usa un enlace o un paréntesis.

Cuándo usarlas (y cuándo no)

Sí: citar una fuente, aclarar un término para quien no lo conozca, dar una cifra exacta sin romper el ritmo, matizar una afirmación.

No: información que el lector necesita para entender la frase. Si es imprescindible, va en el texto. Una nota al pie es opcional por definición: quien no la abra debe poder seguir leyendo sin perderse nada esencial.

Tampoco abuses. Más de tres o cuatro por página y el lector deja de abrirlas.

Pruébalo

Las notas al pie lucen sobre todo en documentos con formato. Exporta tu texto con el conversor a PDF para verlas colocadas y numeradas, o comprueba en el previsualizador que tu procesador las reconoce.

Footnotes

  1. Por John Gruber, con la colaboración de Aaron Swartz.