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 „Gefällt mir“

Nur zur Information, die Erweiterung scheint die normale Markdown-Formatierung für Fußnoten mit [^1] nicht zuzulassen. Ich erhalte keine formatierten Fußnoten, es sei denn, ich verwende die „Inline“-Formatierung, wie hier:

Das Aktivieren von Fußnoten mit Inline-Fußnotenformatierung führt zu automatisch nummerierten Fußnoten, die dann zusammen unter dem Beitrag erscheinen. Gleichzeitig ermöglicht die Aktivierung der Inline-Erweiterung das Ellipsen-Tooltip-ähnliche Erlebnis, ohne dass Fußnoten unter dem Beitrag erscheinen. Wenn Sie die Option für die Inline-Erweiterung aktiviert haben, sieht Ihr Beitrags-Vorschaufenster wie traditionelle nummerierte Fußnoten aus, aber Sie sehen den Inline-Erweiterungseffekt nach der Veröffentlichung.

Ich schätze die automatisch nummerierten Fußnoten mit der Inline-Formatierung, es hat mich nur ein paar Versuche gekostet, herauszufinden, wie ich die Markdown tatsächlich formatieren sollte und welche Optionen sie wie gewünscht verhalten lassen. Hoffentlich hilft dieser Kommentar jemand anderem, die gleiche Verwirrung zu vermeiden.

Bearbeitung zur Ergänzung: Die Inline-Erweiterungsoption ist, wie Ihre Fußnoten auf Mobilgeräten erscheinen, unabhängig davon, ob diese Option aktiviert ist (auch für Desktops).

5 „Gefällt mir“

Rezept zum Erstellen von Inline-Popup-Inhalten mit diesem Discourse-Fußnoten-Plugin:

Kombinieren Sie dieses Plugin mit der Composer Footnote Button Theme Component [1] (es bietet eine Schaltfläche im Composer/Editor zum Erstellen von Fußnoten)

Sie können alles in die Popups einfügen, einschließlich HTML.

Beispiele:

Text [2]


Text und Bild-Upload [3]


HTML-Inhalt [4]


  1. (installieren Sie beide) ↩︎

  2. Einfacher Text hier. ↩︎

  3. Text und Bild-Upload

    ↩︎

  4. Wenn Sie zum ersten Mal auf eine Open-Source-Gruppe stoßen, kann das eine verwirrende Erfahrung sein. Ob Sie zum ersten Mal in eine Mailingliste posten, über das Projekt bloggen, das Sie in Angriff nehmen, oder in einem IRC-Kanal abhängen – die Art und Weise, wie Menschen interagieren, und was sie voneinander erwarten, unterscheidet sich ziemlich stark von der Schule oder von Freunden und Familie.


    Offenheit und Teilen

    Open-Source-Kommunikation kann stark variieren. Ein zentraler gemeinsamer Wert ist, dass das Teilen von Code gut ist. Unabhängig von Lizenz, Sprache oder Einrückungsstil erstellen, teilen und modifizieren Open-Source-Entwickler gemeinsam Quellcode.

    ↩︎

14 „Gefällt mir“

Funktioniert das Fußnoten-Plugin auch auf öffentlichen Seiten? In meinem speziellen Fall möchte ich, dass es NICHT auf öffentlichen Seiten funktioniert und nur in der normalen Themenansicht sichtbar ist (um es für interne Notizen usw. zu verwenden).

@jrgong – nein…

Es gibt jedoch diesen alternativen Ansatz, für den ich gerade eine Theme-Komponente entwickle… auf Github.

2 „Gefällt mir“

Das wurde vor 17 Stunden in den Core verschoben.

Ich überlasse es jemand anderem, dies entsprechend zu aktualisieren.

Übersetzung fehlt: en.Das Discourse-Fußnoten-Plugin wurde in den Discourse-Core integriert. Bitte entfernen Sie das Plugin aus Ihrer app.yml und bauen Sie Ihren Container neu auf.
3 „Gefällt mir“

Nach dem Umzug zu Core,

habe ich das Plugin aus app.yml gelöscht und ./launcher rebuild app ausgeführt,

aber die Einstellungen bleiben auf der Plugin-Seite. Ist es in Ordnung, es einfach so zu belassen?

Das ist das neue. :+1: Hier ist ein Vergleichsfoto von beiden:

alt text

alt text

4 „Gefällt mir“

Das ist ein wirklich schöner Klang! :+1: Danke fürs Teilen. :smiling_face_with_three_hearts:

Danke, dass Sie das erwähnt haben, ich habe gerade eine Korrektur vorgenommen.

3 „Gefällt mir“

Das andere Problem ist, dass Sie das Plugin nicht mehr installieren müssen, und wenn Sie es installiert haben, müssen Sie das git clone nicht in Ihre yml-Datei aufnehmen.

2 „Gefällt mir“

Ich war zu langsam, um das Thema mit den neuen Informationen zu aktualisieren, und du warst schneller als ich. :slight_smile:

Ich werde meinen Teil jetzt trotzdem hinzufügen…


:information_source: Discourse Footnote ist jetzt Teil des Discourse-Kerns, sodass dieses Plugin nicht mehr separat installiert werden muss. :partying_face:

Wenn Sie selbst hosten, sollten Sie auf Ihrem Dashboard einige Informationen zum Entfernen aus Ihrer app.yml finden.

:discourse2: Von uns gehostet? Diese Änderung wird Sie in keiner Weise beeinträchtigen. :+1: Sie können dieses Plugin weiterhin nutzen und sich keine Sorgen machen.

4 „Gefällt mir“

Ja. Tut mir leid.

Das ist großartig! Ich wusste, dass du einen Plan hattest. Ich hätte einfach warten sollen, da das andere, was ich angesprochen habe, tatsächlich ein Problem war, das von jemand anderem gelöst wurde, und ich hätte einfach geduldig sein sollen, da ich wusste, dass du dich darum kümmern würdest. (Und es ist auch so schön!).

Es sind immer noch weniger als 24 Stunden vergangen, also ist das auch ziemlich gut.

Danke.

4 „Gefällt mir“

3 Beiträge wurden in ein neues Thema aufgeteilt: Fußnotenoption zum Zahnradmenü des Verfassers hinzufügen

Gibt es eine Möglichkeit, die Fußnote normal zu formatieren? Damit sie nicht mit den drei Punkten inline ist, so wie hier?[1]

Und stattdessen so aussieht?


  1. Das sieht komisch aus, finde ich ↩︎

Ist das diese Einstellung?

1 „Gefällt mir“

Ja, aber ich meinte als normaler Benutzer, nicht als Administrator, der eine Einstellung ändert.

Nein, es gibt keine Benutzereinstellung dafür. Nur eine globale Einstellung.

1 „Gefällt mir“

Mir ist aufgefallen, dass die Fußnoten nicht viel gängige Markdown-Syntax innerhalb der Fußnotenklammern zulassen[1].\n\nKeine große Sache, aber es schränkt sicherlich die Funktionalität dessen ein, was man in die Fußnote einfügen kann!


  1. z. B. Dies befindet sich in einer Fußnotenklammer, aber das Layout bricht zusammen, sobald ich Absätze, Überschriften, Listen usw. einführe.\n\nHier ist ein Absatzumbruch. ↩︎

Sie können, stellen Sie sicher, dass Sie mit mindestens 4 Leerzeichen einrücken.

Zum Beispiel:


Hier ist ein Fußnotenverweis[^1] und ein weiterer[^longnote].

[^1]: Hier ist die Fußnote.

[^longnote]: Hier ist eine mit mehreren Blöcken.

    Nachfolgende Absätze sind eingerückt, um zu zeigen, dass sie
zur vorherigen Fußnote gehören.

    * Punkt1
    * Punkt 2

    **Mehr** Text

    *kursiv*

Hier ist ein Fußnotenverweis[1] und ein weiterer[2].

Wird gerendert zu:


  1. Hier ist die Fußnote. ↩︎

  2. Hier ist eine mit mehreren Blöcken.

    Nachfolgende Absätze sind eingerückt, um zu zeigen, dass sie
    zur vorherigen Fußnote gehören.

    • Punkt1
    • Punkt 2

    Mehr Text

    kursiv ↩︎