Discourse Footnote

Discourse · 4월 4, 2018, 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 · 9월 29, 2022, 8:51오후

확장 기능이 [^1]을 사용하여 일반적인 마크다운 각주 형식을 지원하지 않는 것 같다는 점을 알려드립니다. “인라인” 형식을 사용하지 않는 한, 서식화된 각주가 표시되지 않습니다. 다음과 같이 말입니다:

Sam Saffron:

“인라인” 각주도 사용할 수 있습니다 — 인라인 확장(inline expansion)이 아니라 각주 자체를 말합니다. 다음과 같이요:
More wise sayings ^[Lincoln, or Einstein, or something]

인라인 각주 형식을 사용하여 각주를 활성화하면 자동 번호가 매겨진 각주가 게시글 아래에 함께 표시됩니다. 또한 인라인 확장을 함께 활성화하면, 각주가 게시글 아래에 표시되지 않고 말줄임표(…) 툴팁과 유사한 경험을 제공합니다. 인라인 확장 옵션이 활성화되어 있으면, 게시글 미리보기 창은 전통적인 번호 매김 각주처럼 보이지만, 게시 후에는 인라인 확장 효과가 표시됩니다.

인라인 형식을 사용한 자동 번호 매김 각주는 유용하지만, 마크다운을 실제로 어떻게 서식 지정해야 하고 어떤 옵션을 선택해야 원하는 대로 작동하는지 파악하는 데 몇 번의 시도가 필요했습니다. 이 댓글이 다른 사람들이 같은 혼란을 겪지 않도록 도움이 되기를 바랍니다.

추가 편집: 인라인 확장 옵션은 해당 옵션이 활성화되어 있든(데스크톱용도 포함) 없든, 모바일에서 각주가 어떻게 표시될지를 결정합니다.

denvergeeks · 5월 10, 2023, 8:44오전

이 Discourse 각주 플러그인을 사용하여 사용자가 인라인 팝업 콘텐츠를 만들 수 있도록 하는 방법:

이 플러그인을 Composer 각주 버튼 테마 컴포넌트 ^[1](Composer/에디터에서 각주를 만들 수 있는 버튼을 제공합니다)와 함께 사용하세요.

팝업 안에는 HTML을 포함하여 무엇이든 넣을 수 있습니다.

예시:

텍스트 ^[2]

텍스트 및 이미지 업로드 ^[3]

HTML 콘텐츠 ^[4]

(둘 다 설치) ↩︎
여기에 일반 텍스트 입력. ↩︎
텍스트 및 이미지 업로드

cookie-monster360×360 22.5 KB
↩︎
brainstorm524×320 34.2 KB
오픈 소스 그룹을 처음 접하면 혼란스러운 경험이 될 수 있습니다. 메일링 리스트에 처음 글을 올리거나, 참여 중인 프로젝트에 대해 블로그를 쓰거나, IRC 채널에서 시간을 보내는 경우 등 - 사람들이 상호작용하는 방식과 서로에게 기대하는 것은 교실이나 친구, 가족 사이와는 꽤 다릅니다.

개방성과 공유
오픈 소스 커뮤니케이션은 다양할 수 있습니다. 공통으로 지니는 핵심 가치는 코드 공유가 좋다는 것입니다. 라이선스, 언어, 들여쓰기 스타일에 관계없이 오픈 소스 개발자들은 함께 소스 코드를 생성, 공유 및 수정합니다.
↩︎

jrgong · 8월 21, 2023, 5:04오후

각주 플러그인이 공개 페이지에서도 작동하나요? 제 경우에는 공개 페이지에서는 작동하지 않고, 일반 토픽 뷰에서만 표시되기를 원합니다(내부 메모 등에 사용하려고 합니다).

denvergeeks · 8월 21, 2023, 6:33오후

@jrgong – 아니요…

다만, 이 대안적 접근 방식에 대해서는 Theme Component를 개발하는 중입니다… Github에서 확인하실 수 있습니다.

pfaffman · 10월 24, 2023, 12:54오후

이 이슈가 17시간 전에 core로 이동된 것 같습니다.

다른 누군가가 적절히 업데이트하도록 하겠습니다.

Translation missing: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.

LoveMCJ · 10월 24, 2023, 1:40오후

코어로 이동한 후,

app.yml에서 플러그인을 삭제하고 ./launcher rebuild app을 실행했는데,

설정 항목이 여전히 플러그인 페이지에 남아 있습니다. 이대로 두어도 괜찮을까요?

JammyDodger · 10월 24, 2023, 1:45오후

이게 새로운 거예요. 비교를 위해 둘 다 찍어 봤습니다:

LoveMCJ · 10월 24, 2023, 1:52오후

정말 좋은 소리네요! 공유해 주셔서 감사합니다.

blake · 10월 24, 2023, 3:50오후

알려주셔서 감사합니다. 방금 수정 사항을 적용했습니다.

pfaffman · 10월 24, 2023, 3:56오후

다른 문제는 더 이상 플러그인을 설치할 필요가 없다는 점입니다. 이미 설치했다면, yml 파일에 해당 git clone을 포함시킬 필요가 없습니다.

JammyDodger · 10월 24, 2023, 3:59오후

새 정보를 가지고 토픽을 업데이트하는 데 내가 좀 느렸는데, 먼저 처리해 주셨네요.

그래도 이제 제 생각을 덧붙여 보겠습니다…

Discourse Footnote 플러그인이 이제 Discourse 코어에 번들로 포함되었으므로, 더 이상 이 플러그인을 별도로 설치할 필요가 없습니다.

자체 호스팅(self-host)을 하고 계신 경우, 대시보드에서 app.yml에서 이 플러그인을 제거해야 한다는 안내를 보실 수 있습니다.

저희가 호스팅을 맡고 계신 경우? 이 변경 사항은 여러분에게 어떤 영향도 미치지 않습니다. 이 플러그인을 계속 즐기셔도 되고, 아무 걱정 하지 않으셔도 됩니다.

pfaffman · 10월 24, 2023, 4:17오후

응. 미안해.

정말 대단해! 계획이 있다는 걸 알았어. 그냥 기다렸어야 했는데, 내가 지적한 다른 문제도 사실 다른 사람이 이미 처리해 놓은 거였거든. 네가 그걸 처리할 거라는 걸 알았으니까 좀 더 인내심을 갖고 기다렸어야 했는데. (그리고 정말 예쁘기도 하고!)

아직 24시간도 안 됐으니까, 그건 꽤 빠른 편이지.

고마워.

JammyDodger · 12월 6, 2023, 8:13오전

3개의 게시물이 새 주제로 분리되었습니다: Add Footnote option to the composer gear menu

Turtle · 2월 13, 2025, 1:52오전

각주를 정상적으로 서식화하는 방법이 있을까요? 세 점(…)과 인라인으로 나열되지 않도록, 이렇게요?^[1]

대신 이렇게 보이게 하고 싶습니다?

이것은 제 눈에 이상해 보입니다 ↩︎

sam · 2월 13, 2025, 1:58오전

이 설정인가요?

Turtle · 3월 8, 2025, 3:20오후

네, 하지만 저는 관리자가 설정을 변경하는 게 아니라 일반 사용자로서 말씀드린 거예요.

Jagster · 3월 8, 2025, 4:54오후

아니요, 해당 기능에 대한 사용자 설정은 없습니다. 전역 설정만 있습니다.

kiefferr · 3월 30, 2025, 6:15오후

각주에는 일반적인 마크다운 구문을 많이 사용할 수 없다는 점을 알아차렸습니다.^[예: 이것은 각주 괄호 안에 있지만, 단락, 헤더, 목록 등을 도입하면 레이아웃이 깨집니다.

여기에는 단락 구분선이 있습니다.]

큰 문제는 아니지만, 각주에 넣을 수 있는 기능의 범위가 확실히 제한됩니다!

Arkshine · 3월 30, 2025, 7:23오후

네, 가능합니다. 최소 4칸 들여쓰기를 반드시 수행하세요.

예를 들어:


여기에는 각주 참조[^1]와 다른 각주[^longnote]가 있습니다.

[^1]: 여기가 각주입니다.

[^longnote]: 여러 블록으로 구성된 각주입니다.

    후속 단락은 들여쓰기를 통해 이전 각주에
속하는 것을 보여줍니다.

    * item1
    * item 2

    **추가** 텍스트

    <em>이탤릭</em>

여기에는 각주 참조^[1]와 다른 각주^[2]가 있습니다.

다음과 같이 렌더링됩니다:

여기가 각주입니다. ↩︎
여러 블록으로 구성된 각주입니다.

후속 단락은 들여쓰기를 통해 이전 각주에
속하는 것을 보여줍니다.
- item1
- item 2
추가 텍스트

이탤릭 ↩︎

글		댓글	조회수
Move footnotes to a standard plugin General	9	1889	3월 31, 2022
Composer Footnote Button Theme component footnote , end-of-life	5	1376	5월 10, 2025
Extend Footnote to include 'annotations' Feature footnote	4	875	10월 26, 2025
Discourse Footnote Plugin Support	2	628	11월 29, 2018
Add Footnote option to the composer gear menu UX composer , footnote , completed	3	455	8월 6, 2025