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 curtidas

[quote=“Sam Saffron, post:1, topic:84533, username:sam”]O consenso geral é que a extensão deve permitir sintaxe como:\n\n\nsome deep thought who needs a reference[^1]\n\n[^1]: Here's the reference. \n\n[/quote]\n\nApenas um aviso de que a extensão não parece permitir a marcação regular para notas de rodapé usando [^1]. Não obtenho notas de rodapé formatadas, a menos que eu use a formatação “inline”, assim:\n\n[quote=“Sam Saffron, post:1, topic:84533, username:sam”]Você também pode usar notas de rodapé “inline” — não a expansão inline, mas a própria nota. Assim:\n\n\nMore wise sayings ^[Lincoln, or Einstein, or something]\n\n[/quote]\n\nHabilitar notas de rodapé usando a formatação de nota de rodapé inline resulta em notas de rodapé numeradas automaticamente que aparecem abaixo da postagem juntas, enquanto habilitar a expansão inline também permite a experiência semelhante a uma dica de expansão com reticências, sem notas de rodapé aparecendo abaixo da postagem. Se você tiver a opção de expansão inline habilitada, sua janela de visualização de postagem parecerá notas de rodapé numeradas tradicionais, mas você verá o efeito de expansão inline após a publicação.\n\nAgradeço as notas de rodapé numeradas automaticamente usando a formatação inline, apenas levei algumas tentativas para descobrir como eu deveria realmente formatar a marcação e quais opções as fariam se comportar como desejado. Espero que este comentário ajude outra pessoa a evitar a mesma confusão.\n\nEditar para adicionar: A opção de expansão inline é como suas notas de rodapé aparecerão no celular, independentemente de essa opção estar habilitada (também para desktop).

5 curtidas

Receita para permitir que seus usuários criem conteúdo de popup inline usando este Plugin de Nota de Rodapé do Discourse:

Combine este Plugin com o Componente de Tema de Botão de Nota de Rodapé do Composer [1] (ele fornece um botão no Composer/Editor para criar notas de rodapé)

Você pode colocar qualquer coisa dentro dos popups, incluindo HTML.

Exemplos:

Texto [2]


Texto e Upload de Imagem [3]


Conteúdo HTML [4]


  1. (instale ambos) ↩︎

  2. Texto simples aqui. ↩︎

  3. Texto e Upload de Imagem

    ↩︎

  4. Quando você encontra um grupo de código aberto pela primeira vez, pode ser uma experiência desconcertante. Seja postando em uma lista de e-mails pela primeira vez, escrevendo sobre o projeto que você está assumindo ou passando tempo em um canal IRC - a maneira como as pessoas interagem e o que elas esperam umas das outras é bem diferente da sala de aula ou com amigos e familiares.


    Abertura e Compartilhamento

    A comunicação de código aberto pode variar muito. Um valor central em comum é que compartilhar código é bom. Independentemente da licença, linguagem ou estilo de indentação, os desenvolvedores de código aberto criam, compartilham e modificam código-fonte juntos.

    ↩︎

14 curtidas

O plugin de nota de rodapé também funciona em páginas públicas? No meu caso específico, quero que ele NÃO funcione em páginas públicas e que seja visível apenas na visualização normal do tópico (para usá-lo para anotações internas, etc.)

@jrgong – não…

No entanto, existe esta abordagem alternativa para a qual estou desenvolvendo um Componente de Tema… no Github.

2 curtidas

Parece que isso foi movido para o core há 17 horas.

Deixarei que outra pessoa atualize isso apropriadamente.

Tradução em falta: en. O plugin discourse-footnote foi integrado ao core do discourse. Por favor, remova o plugin do seu app.yml e reconstrua seu container.
3 curtidas

Após a migração para o core,

Excluí o plugin de app.yml e executei ./launcher rebuild app,

mas as configurações permanecem na página do plugin. Tudo bem deixá-lo assim?

Essa é a nova. :+1: Aqui está uma foto de ambas para comparação:

old one

new one

4 curtidas

Esse é um som muito bom! :+1: Obrigado por compartilhar. :smiling_face_with_three_hearts:

Obrigado por mencionar isso, acabei de enviar uma correção.

3 curtidas

O outro problema é que você não precisa mais instalar o plugin e, se o tiver instalado, não precisará incluir o git clone no seu arquivo yml.

2 curtidas

Fui muito lento para atualizar o tópico com as novas informações e você o fez antes de mim. :slight_smile:

Vou adicionar minha parte agora de qualquer maneira…


:information_source: O Discourse Footnote agora foi incluído no core do Discourse, portanto, este plugin não precisará mais ser instalado separadamente. :partying_face:

Se você auto-hospeda, deverá ver algumas informações no seu painel sobre como removê-lo do seu app.yml.

\u003e:discourse2: Hospedado por nós? Esta alteração não o afetará de forma alguma. :+1: Você pode continuar aproveitando este plugin e não se preocupar com nada.

4 curtidas

Sim. Desculpe por isso.

Isso é incrível! Eu sabia que você tinha um plano. Eu deveria ter esperado, pois a outra coisa que apontei era, de fato, um problema que foi, de fato, resolvido por outra pessoa, e eu deveria ter sido paciente, já que sabia que você iria lidar com isso. (E é tão bonito também!).

Ainda não se passaram 24 horas, então, sabe, isso também é muito bom.

Obrigado.

4 curtidas

3 posts foram divididos em um novo tópico: Opção de adicionar nota de rodapé ao menu de engrenagem do compositor

Existe uma maneira de fazer a nota de rodapé ser formatada normalmente? Para que não fique em linha com os três pontos, assim?[1]

E em vez disso, ter a aparência assim?


  1. Isso parece estranho, para mim ↩︎

É esta configuração?

1 curtida

Sim, mas eu quis dizer como um usuário comum, não um administrador alterando uma configuração.

Não, não há uma configuração de usuário para isso. Apenas uma global.

1 curtida

Notei que a criação de notas de rodapé não permite o uso de muita sintaxe markdown comum dentro dos colchetes da nota de rodapé[1]\n\nNã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 nota de rodapé, mas o layout quebra sempre que introduzo parágrafos, cabeçalhos, listas, etc.\n\nAqui está uma quebra de parágrafo. ↩︎

Você pode, certifique-se de recuar com pelo menos 4 espaços.

Por exemplo:


Aqui está uma referência de nota de rodapé[^1], e outra[^longnote].

[^1]: Aqui está a nota de rodapé.

[^longnote]: Aqui está uma com vários blocos.

    Parágrafos subsequentes são recuados para mostrar que eles
pertencem à nota de rodapé anterior.

    * item1
    * item 2

    **Mais** texto

    *itálico*

Aqui está uma referência de nota de rodapé[1], e outra[2].

Renderiza para:


  1. Aqui está a nota de rodapé. ↩︎

  2. Aqui está uma com vários blocos.

    Parágrafos subsequentes são recuados para mostrar que eles
    pertencem à nota de rodapé anterior.

    • item1
    • item 2

    Mais texto

    itálico ↩︎