Footnote — 흐름 안 끊는 메모

~10 min · markdown, footnotes, pandoc

Level 0평문

0 XP0/64 lessons0/12 achievements

0/100 XP to next level100 XP to go0% complete

Footnote 가 본문을 깨끗하게 유지한다

Footnote 는 본문을 깨지 않고 한 단어에 부연을 달아. 참조 문법은 [^id]; 정의는 [^id]: footnote 본문 으로 파일 어디든 둬. 렌더러가 정의를 모아 참조된 순서대로 번호 매기고 footnote 섹션 emit 해.

다중 문단 footnote

Footnote 가 여러 문단 가능. 이어지는 문단을 4 칸 (또는 1 탭) 들여써서 같은 footnote 에 붙여둬.

Footnote 가 사는 곳 (과 안 사는 곳)

Footnote 는 CommonMark 엔 없어. GFM (2021 부터), pandoc, MultiMarkdown, 대부분 modern 정적 사이트 생성기에서 지원. strict CommonMark 타깃이면 plain 괄호 옆길이나 섹션 끝 노트로 fallback.

원칙: footnote 는 독자가 안전하게 건너뛸 수 있는 맥락을 추가해야 해. 핵심 정보는 본문에. footnote 는 불편한 진실 묻는 곳 아냐.

Code

한 줄 footnote·markdown

Markdown was created in 2004[^gruber] and standardized as CommonMark[^cm].

[^gruber]: By John Gruber and Aaron Swartz.
[^cm]: First spec published 2014, current version 0.31.2.

다중 문단 footnote·markdown

The Norway problem[^norway] is YAML's most famous gotcha.

[^norway]: In YAML 1.1, unquoted `no` parses as boolean false.

    So `country: NO` reads as `country: False`. The fix is to
    quote the string or upgrade to YAML 1.2 where this was removed.

순서 무관 (정의는 어디든 가능)·markdown

[^cm]: First spec published 2014.

# Document title

Markdown is from 2004[^gruber] and standardized as CommonMark[^cm].

[^gruber]: By John Gruber and Aaron Swartz.

External links

Exercise

기존 문서 한 문단 골라 — 괄호 옆길 ('(see also: ...)' 또는 'NB: ...') 가 있는 거. 옆길 하나하나 semantic ID 의 footnote 로 변환. 두 버전 나란히 읽어봐. 옆길이 아래로 내려가면서 본문이 얼마나 더 숨 쉬는지 느껴봐.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousStrikethrough, autolink, inline 참조 Next →Alert — > [!NOTE], [!WARNING], 그리고 친구들

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.