Discourse Footnote

Discourse · 2018 年 4 月 4 日午前 6:11


	Summary	Discourse Footnote allows users to create markdown footnotes in posts.
	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:

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:

image790×224 3.82 KB

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

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.

The footnote ↩︎
The second footnote ↩︎

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

Check document
Perform check on document:

Kayla · 2022 年 9 月 29 日午後 8:51

Sam Saffron:

一般的なコンセンサスは、拡張機能は次のような構文を許可すべきであるということです。
some deep thought who needs a reference[^1]

[^1]: Here's the reference.

拡張機能は、[^1] を使用した通常の脚注のマークダウンを許可していないようです。注意しておきます。インライン形式を使用しない限り、脚注はフォーマットされません。

Sam Saffron:

「インライン」脚注（インライン展開ではなく、注釈自体）も使用できます。このように：
More wise sayings ^[Lincoln, or Einstein, or something]

インライン脚注形式を使用して脚注を有効にすると、自動番号付きの脚注が投稿の下にまとめて表示されます。また、インライン展開を有効にすると、投稿の下に脚注が表示されない、エリプシスツールチップのような体験が得られます。インライン展開オプションが有効になっている場合、投稿プレビューウィンドウは従来の番号付き脚注のように見えますが、公開後はインライン展開効果が表示されます。

インライン形式を使用した自動番号付き脚注はありがたいのですが、マークダウンをどのようにフォーマットすべきか、そして望ましい動作を得るためにどのオプションを使用すべきかを理解するのに数回試行錯誤しました。このコメントが他の人の混乱を避けるのに役立つことを願っています。

追記：インライン展開オプションは、そのオプションが有効になっているかどうかに関わらず（デスクトップでも）、モバイルで脚注がどのように表示されるかです。

denvergeeks · 2023 年 5 月 10 日午前 8:44

このDiscourseフットノートプラグインを使用して、ユーザーがインラインポップアップコンテンツを作成できるようにするレシピ：

このプラグインとComposer Footnote Button Theme Componentを組み合わせます ^[1]（これにより、コンポーザー/エディターにフットノートを作成するためのボタンが提供されます）

ポップアップ内にはHTMLを含むあらゆるものを配置できます。

例：

テキスト ^[2]

テキストと画像のアップロード ^[3]

HTMLコンテンツ ^[4]

(両方をインストールしてください) ↩︎
ここにプレーンテキストが入ります。 ↩︎
テキストと画像のアップロード

cookie-monster360×360 22.5 KB
↩︎
brainstorm524×320 34.2 KB
初めてオープンソースグループに出会ったとき、それは当惑するような経験かもしれません。メーリングリストに初めて投稿するときも、取り組んでいるプロジェクトについてブログを書くときも、IRCチャンネルでチャットするときも、人々が交流する方法や、お互いに期待することは、教室や友人や家族との間とはかなり異なります。

オープンネスと共有
オープンソースのコミュニケーションは大きく異なる場合があります。共通して持っている中核的な価値観は、コードを共有することは良いということです。ライセンス、言語、インデントスタイルに関係なく、オープンソース開発者はソースコードを一緒に作成、共有、変更します。
↩︎

jrgong · 2023 年 8 月 21 日午後 5:04

フッタープラグインは公開ページでも機能しますか？私の特定のケースでは、公開ページでは機能せず、通常のトピックビューでのみ表示されるようにしたいです（内部メモなどに使用するため）。

denvergeeks · 2023 年 8 月 21 日午後 6:33

@jrgong – いいえ…

ただし、この代替アプローチがあり、現在テーマコンポーネントを開発中です… Githubで。

pfaffman · 2023 年 10 月 24 日午後 12:54

これは17時間前にコアに移されたようです。
誰か適切な方に更新してもらいます。

翻訳が見つかりません: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.

LoveMCJ · 2023 年 10 月 24 日午後 1:40

コアに移行した後、
app.ymlからプラグインを削除し、./launcher rebuild appを実行しましたが、
設定はプラグインページに残ったままです。このままにしておいても大丈夫でしょうか？

JammyDodger · 2023 年 10 月 24 日午後 1:45

それが新しいものです。比較のために両方の写真を載せます。

LoveMCJ · 2023 年 10 月 24 日午後 1:52

それはとても良い音ですね！シェアしてくれてありがとう。

blake · 2023 年 10 月 24 日午後 3:50

これについて言及していただきありがとうございます。修正をプッシュしました。

pfaffman · 2023 年 10 月 24 日午後 3:56

もう一つの問題は、プラグインをインストールする必要がなくなったことです。もしインストールしてしまった場合は、git clone を yml ファイルに含める必要はありません。

JammyDodger · 2023 年 10 月 24 日午後 3:59

新しい情報でトピックを更新するのが遅すぎたので、あなたが先にやってしまいました。

それでも私の部分を追加します…

Discourse Footnote は Discourse コアにバンドルされたので、このプラグインを個別にインストールする必要はなくなりました。

セルフホストしている場合は、ダッシュボードに app.yml から削除する方法に関する情報が表示されるはずです。

当社でホストされていますか？この変更はあなたには一切影響しません。このプラグインを引き続きお楽しみいただけ、何も心配する必要はありません。

pfaffman · 2023 年 10 月 24 日午後 4:17

ええ、すみません。

素晴らしいですね！計画があったのですね。待っていればよかったです。私が指摘したもう一つのことは、実際には誰か他の人が対処した問題でした。あなたが対応してくれるとわかっていたので、ただ待っていればよかったのです。（それに、とても綺麗ですし！）

まだ24時間も経っていないので、それもまた良いことですね。

ありがとうございます。

JammyDodger · 2023 年 12 月 6 日午前 8:13

3件の投稿が新しいトピックに分割されました：コンポーザーのギアメニューに脚注オプションを追加

Turtle · 2025 年 2 月 13 日午前 1:52

脚注を通常の書式設定で表示する方法はありますか？このように3つのドットとインラインにならないようにするにはどうすればよいですか？^[1]\n\n代わりにこのように表示するにはどうすればよいですか？

これは奇妙に見えます ↩︎

sam · 2025 年 2 月 13 日午前 1:58

この設定ですか？

Turtle · 2025 年 3 月 8 日午後 3:20

いや、しかし、管理者が設定を変更するのではなく、一般ユーザーとしてという意味でした。

Jagster · 2025 年 3 月 8 日午後 4:54

いいえ、そのためのユーザー設定はありません。グローバル設定のみです。

kiefferr · 2025 年 3 月 30 日午後 6:15

フットノートでは、フットノートの括弧内に一般的なMarkdown構文をあまり使用できないことに気づきました^[1]\n\n大きな問題ではありませんが、フットノートに入れられる機能が制限されることは確かです！

例：これはフットノートの括弧内にありますが、段落、ヘッダー、リストなどを導入するとレイアウトが崩れます。\n\nここに段落の区切りがあります。 ↩︎

Arkshine · 2025 年 3 月 30 日午後 7:23

{“translation”: "少なくとも4つのスペースでインデントを付けるようにしてください。

例：


ここに脚注の参照があります[^1]、もう一つ[^longnote]。

[^1]: こちらが脚注です。

[^longnote]: 複数のブロックを含む例。

    以降の段落はインデントされていて、それらが
前の脚注に属していることを示します。

    * アイテム1
    * アイテム2

    **もっと**テキスト

    <em>italic</em>
``` （原文のHTMLタグと記号は保持してください）

脚注の例：

![image|387x219](upload://rKf3zv09pn1uwmMDpXGQrWxHK7m.png)"}

トピック		返信	表示
Move footnotes to a standard plugin General	10	1765	2022 年 10 月 30 日
Composer Footnote Button Theme component footnote , end-of-life	5	1232	2025 年 5 月 10 日
Extend Footnote to include 'annotations' Feature footnote	4	614	2025 年 10 月 26 日
Discourse Footnote Plugin Support	3	554	2018 年 12 月 29 日
Add Footnote option to the composer gear menu UX composer , footnote , completed	3	364	2025 年 8 月 6 日