Discourse Footnote

:discourse2: Summary Discourse Footnote allows users to create markdown footnotes in posts.
:open_book: Install Guide This plugin is bundled with Discourse core. There is no need to install the plugin separately.

Enabling Footnote

The Footnote plugin is default enabled but can be disabled/enabled from the admin/plugins page:

enable footnote

Features

Once enabled, you can add footnotes to your posts by typing them in like this:

A sentence that needs a footnote. ^[The footnote] 
Another sentence that needs a footnote. ^[The second footnote]

Or like this:

A sentence that needs a footnote. [^1] 
Another sentence that needs a footnote. [^2]

[^1]: The footnote
[^2]: The second footnote

You can mix and match both styles within a post, as well as use non-numbered anchors.

There are two ways to display the footnotes, controlled by the display footnotes inline admin setting:

Non-inline:

Inline:

A sentence that needs a footnote[1]
Another sentence that needs a footnote[2]

The inline versions are both Quote and mobile-friendly.

Settings

Name Description
enable markdown footnotes enable footnote markdown on this site
display footnotes inline enable inline expansion of footnotes

:discourse2: Hosted by us? This plugin is available on all of our hosting tiers Footnote | Discourse - Civilized Discussion

Development History

Discourse footnote re-packages the footnote markdown.it extension by @Vitaly as a Discourse plugin.


  1. The footnote ↩︎

  2. The second footnote ↩︎

Last edited by @tobiaseigen 2025-07-16T20:45:27Z

Check documentPerform check on document:
72 Me gusta

[quote=“Sam Saffron, post:1, topic:84533, username:sam”]El consenso general es que la extensión debería permitir sintaxis como:\n\n\nalgún pensamiento profundo que necesita una referencia[^1]\n\n[^1]: Aquí está la referencia.\n\n[/quote]\n\nSolo una advertencia de que la extensión no parece permitir el markdown regular para notas al pie usando [^1]. No obtengo notas al pie formateadas a menos que use el formato “inline”, así:\n\n[quote=“Sam Saffron, post:1, topic:84533, username:sam”]También puedes usar notas al pie “inline” — no la expansión inline, sino la nota en sí. Así:\n\n\nMás dichos sabios ^[Lincoln, o Einstein, o algo así]\n\n[/quote]\n\nHabilitar las notas al pie usando el formato de nota al pie inline da como resultado notas al pie auto-numeradas que luego aparecen juntas debajo de la publicación, mientras que habilitar también la expansión inline permite la experiencia similar a un tooltip de elipsis sin que aparezcan notas al pie debajo de la publicación. Si tienes habilitada la opción de expansión inline, tu ventana de vista previa de la publicación se verá como notas al pie numeradas tradicionales, pero verás el efecto de expansión inline después de publicar.\n\nAprecio las notas al pie numeradas automáticamente usando el formato inline, solo me tomó algunos intentos averiguar cómo debería formatear el markdown y qué opciones harían que se comportaran como se desea. Espero que este comentario ayude a alguien más a evitar la misma confusión.\n\nEditar para agregar: La opción de expansión inline es cómo aparecerán tus notas al pie en el móvil, independientemente de si esa opción está habilitada (también para escritorio).

5 Me gusta

Receta para permitir a tus usuarios crear contenido emergente en línea usando este Plugin de Notas al Pie de Discourse:

Combina este Plugin con el Componente Temático del Botón de Notas al Pie del Compositor [1] (proporciona un botón en el Compositor/Editor para crear notas al pie)

Puedes poner cualquier cosa dentro de los emergentes, incluyendo HTML.

Ejemplos:

Texto [2]


Texto y Carga de Imagen [3]


Contenido HTML [4]


  1. (instálalos ambos) ↩︎

  2. Texto plano aquí. ↩︎

  3. Texto y Carga de Imagen

    ↩︎

  4. Cuando te encuentras con un grupo de código abierto por primera vez, puede ser una experiencia desconcertante. Ya sea publicando en una lista de correo por primera vez, escribiendo sobre el proyecto que estás emprendiendo o pasando el rato en un canal de IRC, la forma en que las personas interactúan y lo que esperan unas de otras es bastante diferente a lo que se experimenta en el aula o con amigos y familiares.


    Apertura y Compartir

    La comunicación de código abierto puede variar mucho. Un valor central compartido es que compartir código es bueno. Independientemente de la licencia, el idioma o el estilo de sangría, los desarrolladores de código abierto crean, comparten y modifican código fuente juntos.

    ↩︎

14 Me gusta

¿El plugin de notas al pie también funciona en páginas públicas? En mi caso específico, quiero que NO funcione en páginas públicas y solo sea visible en la vista normal del tema (para usarlo para notas internas, etc.)

@jrgong – no…

Sin embargo, existe este enfoque alternativo para el cual estoy desarrollando un Componente de Tema… en Github.

2 Me gusta

Parece que esto se movió al núcleo hace 17 horas.

Dejaré que alguien más actualice esto apropiadamente.

Falta la traducción: en.El plugin discourse-footnote se ha integrado en el núcleo de Discourse. Elimina el plugin de tu app.yml y reconstruye tu contenedor.
3 Me gusta

Después de moverlo al núcleo,

Eliminé el plugin de app.yml y ejecuté ./launcher rebuild app,

pero la configuración permanece en la página del plugin. ¿Está bien dejarlo así?

Esa es la nueva. :+1: Aquí hay una foto de ambas para comparar:

old one

new one

4 Me gusta

¡Ese es un sonido realmente agradable! :+1: Gracias por compartir. :smiling_face_with_three_hearts:

Gracias por mencionarlo, acabo de implementar una solución.

3 Me gusta

El otro problema es que ya no necesitas instalar el plugin, y si lo has instalado, no necesitas incluir ese git clone en tu archivo yml.

2 Me gusta

Llegué tarde a actualizar el tema con la nueva información y me ganaste. :slight_smile:

Aún así añadiré mi parte…


:information_source: Discourse Footnote ahora se ha incluido en el núcleo de Discourse, por lo que este plugin ya no necesitará instalarse por separado. :partying_face:

Si alojas tu propio servidor, deberías ver información en tu panel sobre cómo eliminarlo de tu app.yml.

:discourse2: ¿Alojado por nosotros? Este cambio no te afectará en absoluto. :+1: Puedes seguir disfrutando de este plugin y no preocuparte por nada.

4 Me gusta

Sí. Lamento eso.

¡Eso es genial! Sabía que tenías un plan. Debería haber esperado, ya que la otra cosa que señalé era, de hecho, un problema que fue, de hecho, resuelto por otra persona, y debería haber sido paciente ya que sabía que lo ibas a manejar. (¡Y también es muy bonito!).

Todavía no han pasado 24 horas, así que, ya sabes, eso también está bastante bien.

Gracias.

4 Me gusta

Se dividieron 3 publicaciones en un nuevo tema: Opción de agregar nota al pie al menú de engranaje del compositor

¿Hay alguna forma de que la nota al pie tenga un formato normal? Para que no esté en línea con los tres puntos, ¿así?[1]

¿Y que en su lugar se vea así?


  1. Esto se ve raro, para mí ↩︎

¿Es esta la configuración?

1 me gusta

Sí, pero me refería como un usuario normal, no como un administrador que cambia una configuración.

No, no hay configuración de usuario para eso. Solo la global.

1 me gusta

Noto que a anotação de rodapé não permite o uso de muita sintaxe markdown comum dentro dos colchetes do rodapé[1]

Não é um grande problema, mas certamente limita a funcionalidade do que você pode colocar na nota de rodapé!


  1. Ex: Isto está dentro de um colchete de rodapé, mas o layout quebra sempre que introduzo parágrafos, cabeçalhos, listas, etc.\n\nAqui está uma quebra de parágrafo. ↩︎

Puedes hacerlo, asegúrate de usar una sangría de al menos 4 espacios.

Por ejemplo:


Aquí hay una referencia de nota al pie[^1], y otra[^longnote].

[^1]: Aquí está la nota al pie.

[^longnote]: Aquí hay una con varios bloques.

    Los párrafos subsiguientes están indentados para mostrar que pertenecen a la nota al pie anterior.

    * elemento1
    * elemento 2

    **Más** texto

    *en cursiva*

Aquí hay una referencia de nota al pie[1], y otra[2].

Se renderiza como:


  1. Aquí está la nota al pie. ↩︎

  2. Aquí hay una con varios bloques.

    Los párrafos subsiguientes están indentados para mostrar que pertenecen a la nota al pie anterior.

    • elemento1
    • elemento 2

    Más texto

    en cursiva ↩︎