Better Footnote

English | 中文 | 日本語 | 한국어

A footnote sidebar workspace for academic and long-form writing in Obsidian.

☕ Better Footnote is free and will stay free. If it saves you time in your writing, you can buy me a coffee.

Better Footnote gathers the footnotes in the current note into a stable right sidebar. It lets you add, edit, search, expand, and delete footnotes directly, while moving between in-text footnote markers, sidebar cards, and footnote definitions without losing your place.

Quick Start

1. Install and enable Better Footnote from Obsidian's Community plugins.
2. Open the sidebar: click this icon in Obsidian's left ribbon , or run Open Better Footnote from the command palette.
3. Open a Markdown note with standard footnote definitions such as [^1]: Reference text or [^citation]: Reference text.
4. Edit or search footnotes in the right sidebar, or click + beside the search box to add one. Changes are saved automatically.

Why Use It

Obsidian footnotes are flexible, but they become hard to work with in long notes, papers, and research drafts:

• The in-text marker and the footnote definition are often far apart.
• Editing a footnote usually means scrolling to the bottom of the note and then finding your way back.
• Searching for repeated citations in the whole note can mix footnote hits with body text hits.
• Long footnotes need more room, while short footnotes should stay compact.
• Deleting a footnote cleanly means removing both the reference marker and the definition.
• Typing a footnote definition such as [^4]: by hand takes several steps, and an input method can turn its brackets and colon full-width, so it looks right but is not a footnote.
• Newly inserted footnotes often need numbering and definition order cleaned up.

Better Footnote turns footnotes into a right-side editing workspace instead of a block of text hidden at the end of the note.

Supported Footnotes

Better Footnote focuses on standard Markdown footnote definitions:

Text with a footnote.[^1]
Text with a named footnote.[^citation]

[^1]: A footnote definition.
[^citation]: A named footnote definition.
    Continued lines stay inside the same footnote.

Named ids such as [^citation] are supported. The sidebar shows the real id, while Obsidian may render the footnote as part of the normal numbered sequence in reading mode.

Inline footnotes such as ^[inline text] are not edited from the sidebar.

Footnote syntax written inside code blocks, inline code, %% comments, HTML comments, $$ math or the properties block is treated as plain text: it gets no card and is never changed when you edit or delete a footnote.

Core Workflow

• Click an in-text [^id] marker to select the matching footnote card in the sidebar.
• Click a sidebar footnote card to jump back to the matching in-text marker and briefly outline it. A card that has no marker in the note yet leaves the note where it is.
• Put the cursor inside a footnote definition near the bottom of the note to select the same footnote in the sidebar.
• Edit the footnote in the sidebar. Changes are saved back to the Markdown file automatically.
• When you insert a new footnote while Better Footnote is showing, the cursor moves into its card, so you type the content there instead of in the popup that the insert command opens. To type in that popup instead, close the Better Footnote tab while you insert footnotes.

The sidebar shows the real [^id] from the note, keeps footnotes in definition order, and marks definitions without an in-text reference as unreferenced.

If the sidebar also holds other tabs, turn on Switch to Better Footnote when clicking a reference marker in the settings: clicking a marker then switches the open sidebar to Better Footnote and shows that footnote. You can also drag the Better Footnote tab into a pane of its own in the sidebar, so it stays visible next to the others.

Tidy Footnotes Integration

With Tidy Footnotes installed, you can turn on "Auto tidy after a new footnote" in the settings:

• After you insert a new footnote, Better Footnote runs Tidy Footnotes, so the new footnote gets its number and its place among the definitions. Footnotes that arrive from Sync or from scripts are only highlighted.
• Deleting a footnote does not tidy, so a single undo brings it back. Run Tidy Footnotes yourself when you are ready.
• It works while Better Footnote is open.

Draft First, Place Later

You can write a footnote before you decide where it goes. Click + beside the search box to add an empty footnote with the next free number after the last footnote definition; its card opens for writing. When you know where it belongs, click the number on the card to copy its marker (such as [^41]) and paste it into the note. Clicking the number only copies: the note and your cursor stay where they are, so you can paste right away. You can also copy from the card's right-click menu.

Until its marker is in the note, the card is marked unreferenced, and clicking it leaves the note where it is. + is shown while the search box is empty.

Multiple References

If the same footnote id appears more than once in the text, Better Footnote keeps one sidebar card for the single footnote definition and shows how many references point to it. When that card is selected, small previous/next buttons cycle through each in-text reference and flash the exact marker.

This works for named ids such as [^citation] and for repeated numeric ids such as [^1]. It does not change the note, renumber footnotes, or run Tidy Footnotes.

Footnote Search

The sidebar search box searches only footnotes. You can filter by number, id, or content without matching unrelated body text.

If you already know the footnote number or name, type ^ before it to jump directly to that footnote. For example, ^42 only matches footnote 42, and ^citation only matches footnote citation. Plain 42 remains a normal search across footnote numbers, ids, and content.

Words separated by spaces are searched separately, and each word is highlighted on its own. To search for several words as one phrase, put them in double quotes, for example "Hey Jude"; Chinese quotes “ ” work too. Chinese and Japanese text typed without spaces is already searched as written.

When the search text appears multiple times, each occurrence is counted separately. Use the up/down buttons to move through exact matches. Better Footnote scrolls to the matching footnote, expands it if needed, and selects the matched text inside the footnote editor so you can see the exact hit.

Clearing the search returns search-expanded footnotes to their compact state.

Long Footnotes and Counts

Long footnotes stay compact by default. An expand button appears only when the editor content is actually clipped, so short footnotes do not take unnecessary space.

The footer of each footnote shows a live count. In Auto mode, English counts words, while Chinese, Japanese, and Korean count characters. You can override this in settings when your writing language differs from the interface language.

Markdown Rendering (Optional)

By default, footnote cards show the raw Markdown source in an editor box. If your footnotes contain many links or formatted text, turn on Render Markdown in sidebar in settings.

When enabled, footnote cards you are not editing show rendered Markdown: links, bold, italics, internal links, and other formatting. Click a link to open it directly; internal [[wikilinks]] open in the workspace. Click any other text to edit: the card switches in place to an embedded live preview editor, so formatting stays rendered while you type and the Markdown syntax unfolds around the cursor. The cursor lands near where you clicked. (One known limit: editor hotkeys such as Ctrl/Cmd+B do not respond inside the card; type the Markdown syntax directly instead.) Click back into the note or press Esc to save and return to the rendered view. Switching to another app while editing keeps the editing state, so you can look up a reference and come back. If the live preview editor is unavailable, the card falls back to the plain source editor automatically.

The setting is off by default. Counts always follow the Markdown source, not the rendered text.

Deleting a Footnote

Right-click a footnote card in the sidebar and choose Delete this footnote. After confirmation, Better Footnote removes both the in-text reference marker and the footnote definition in one editor change. If two definitions share one number, only the definition of the card you delete is removed, and the reference markers stay with the other one.

To undo, click back into the note editor and press Command+Z on macOS or Ctrl+Z on Windows/Linux. Repeated undo works through Obsidian's normal editor history. Better Footnote does not tidy numbering after deletion; run Tidy Footnotes manually when you are ready.

Languages

The interface follows Obsidian's language first, then the system language, and falls back to English. English, Chinese, Japanese, and Korean UI strings are included.

中文

Better Footnote 是一个用于 Obsidian 的脚注侧栏工作台。它面向长文、论文和研究笔记：把当前笔记里的脚注集中放到右侧边栏，让你可以直接新建、编辑、搜索、展开、删除脚注，并在正文脚注标记、侧栏脚注卡片和文末脚注定义之间快速定位。

快速开始

1. 在 Obsidian 第三方插件中安装并启用 Better Footnote。
2. 打开侧栏：点击 Obsidian 左侧图标条里的这个图标 ，或者在命令面板中运行 Open Better Footnote。
3. 打开包含标准脚注定义的 Markdown 笔记，例如 [^1]: 引用内容 或 [^citation]: 引用内容。
4. 在右侧边栏编辑或搜索脚注，也可以点搜索框旁的 + 新建一条。修改会自动保存。

为什么需要它

Obsidian 的脚注语法很灵活，但在长文、论文和研究草稿中，脚注一多就很容易打断写作节奏：

• 正文里的脚注标记和文末脚注定义经常离得很远。
• 修改一条脚注时，常常要滚到文末，再想办法回到正文。
• 想查某个文献或表述是否已经在脚注中出现过，只能全文搜索，容易被正文内容干扰。
• 长脚注需要展开查看，短脚注又不应该占太多侧栏空间。
• 删除一条脚注时，需要同时处理正文引用标记和文末定义，容易漏删。
• 手打一条脚注定义（如 [^4]: ）要好几步，中文输入法还容易把方括号和冒号打成全角，看着对却不算脚注。
• 新增脚注后，编号和文末定义顺序经常还需要整理。

Better Footnote 的思路是把脚注变成一个稳定的右侧编辑工作区，而不是藏在文末的一长串文本。

支持范围

Better Footnote 主要支持标准 Markdown 脚注定义：

正文里的脚注。[^1]
正文里的自定义名称脚注。[^citation]

[^1]: 脚注内容。
[^citation]: 自定义名称脚注内容。
    继续缩进的行仍属于同一条脚注。

也支持 [^citation] 这类自定义名称脚注。侧栏会显示真实 id；Obsidian 在阅读模式中可能会把它作为普通脚注序列的一部分显示为数字。

暂不在侧栏编辑 ^[inline text] 这类 inline footnotes。

写在代码块、行内代码、%% 注释、HTML 注释、$$ 公式或属性区里的脚注语法只当作普通文字：不生成卡片，编辑或删除脚注时也不会被改动。

核心工作流

• 点击正文里的 [^id] 脚注标记，右侧栏会自动选中对应脚注卡片。
• 点击右侧栏脚注卡片，正文中的对应脚注标记会跳转并短暂显示紫色框。还没有正文引用的卡片点击后，正文保持不动。
• 在文末脚注定义区点击或移动光标，右侧栏也会同步选中对应脚注。
• 直接在右侧栏编辑脚注内容，修改会自动保存回 Markdown 文件。
• Better Footnote 显示在侧栏时插入新脚注，光标会进入它的卡片，内容就在卡片里写，而不是在插入命令弹出的小窗里写。想用小窗，请在插入脚注时关掉 Better Footnote 的标签。

侧栏会显示当前文档里的真实 [^id]，按文末定义顺序排列；没有正文引用的脚注定义会标记为“未引用”。

如果侧栏里还放着别的标签，可以在设置中打开 点击引用标记时切换到 Better Footnote：点击正文里的引用标记时，展开着的侧栏会切换到 Better Footnote 并显示这条脚注。也可以把 Better Footnote 的标签拖到侧栏里单独的一格，让它和别的标签同时显示。

Tidy Footnotes 联动

安装 Tidy Footnotes 后，可以在设置中打开“新增脚注后自动整理编号”：

• 你插入新脚注后，Better Footnote 会自动运行 Tidy Footnotes，让新脚注拿到正确的编号、排到正确的位置。同步或脚本带来的新脚注只会高亮。
• 删除脚注不会自动整理，这样按一次撤销就能完整恢复。需要时请自己运行 Tidy Footnotes。
• 这一联动在 Better Footnote 打开时生效。

先写后放

脚注可以先写，再决定放在哪里。点搜索框旁的 +，会在最后一条脚注定义之后加一条下一个编号的空白脚注，卡片直接进入编辑。想好放在哪里后，点卡片上的编号，复制它的引用标记（例如 [^41]），再粘贴到正文。点编号只复制，正文和光标都不动，可以直接粘贴。右键卡片也可以复制。

放进正文之前，卡片显示“未引用”，点它不会移动正文。搜索框为空时才显示 +。

多处引用

如果同一个脚注 id 在正文中出现多次，Better Footnote 仍然只保留一张侧栏卡片，因为文末脚注定义只有一条。侧栏会显示它有几处引用；选中该卡片后，会出现上一处/下一处按钮，可以循环跳转到正文中的每一个引用标记，并短暂高亮当前位置。

这同时适用于 [^citation] 这类自定义 id，也适用于重复出现的数字 id，例如 [^1]。这个功能只负责定位，不会修改正文、重新编号，也不会运行 Tidy Footnotes。

脚注搜索

侧栏搜索框只搜索脚注。你可以按脚注序号、id 或内容过滤，不会被正文中的同词内容干扰。

如果你已经明确知道脚注编号或名称，可以在前面加 ^ 直接定位该条脚注。例如，^42 只匹配脚注 42，^citation 只匹配脚注 citation。普通输入 42 仍然保持原有搜索逻辑，会搜索脚注序号、id 和脚注内容。

用空格分开的多个词会分别查找、分别高亮。想把几个词当成一整句查找，就用双引号括起来，例如 "Hey Jude"，中文引号 “ ” 也可以。中文、日文不打空格时，本来就按整串查找。

若同一个词在同一条脚注中出现多次，每一处都会单独计数。点击上/下按钮时，Better Footnote 会跳到对应匹配项，必要时自动展开长脚注，并直接选中脚注编辑框里的匹配文字，让你看到具体命中位置。

清除搜索后，由搜索自动展开的脚注会恢复为紧凑显示。

长脚注与计数

长脚注默认保持紧凑；只有内容确实显示不全时，才出现展开按钮。因此短脚注不会占用不必要的侧栏空间。

每条脚注左下角会显示实时计数。自动模式下，英文界面统计单词数，中文、日文、韩文界面统计字数。如果写作语言和界面语言不同，可以在设置中改为固定统计字数或单词数。

Markdown 渲染（可选）

默认情况下，脚注卡片以编辑框显示 Markdown 源码。如果你的脚注里有很多链接或格式文本，可以在设置中开启"侧栏渲染 Markdown"。

开启后，未在编辑的脚注卡片会显示渲染后的 Markdown：链接、粗体、斜体、内部链接等格式。点击链接直接打开；[[内部链接]] 会在工作区中打开。点击其他文字即可编辑：卡片原地切换为嵌入式实时预览编辑器，输入时格式保持渲染、光标附近的 Markdown 语法自动展开；光标落在点击位置附近。（已知限制：Ctrl/Cmd+B 等编辑器快捷键在卡片内不响应，可直接输入 Markdown 语法代替。）点回笔记正文或按 Esc 会自动保存并恢复渲染显示。编辑中切换到其他应用不会丢失编辑状态，方便查完资料回来继续。若实时预览编辑器不可用，卡片会自动回退为源码编辑框。

该选项默认关闭。字数统计始终按 Markdown 源码计算，与显示形态无关。

删除脚注

在侧栏脚注卡片上右键，选择“删除本条脚注”。确认后，Better Footnote 会在一次编辑操作中同时删除正文引用标记和文末脚注定义。如果同一个编号有两条定义，只删除你右键的那张卡对应的定义，正文里的引用标记会留给另一条。

如需撤销，请先点击回笔记编辑区，然后在 macOS 上按 Command+Z，在 Windows/Linux 上按 Ctrl+Z。连续撤销会走 Obsidian 正常的编辑历史。Better Footnote 不会在删除后自动整理编号；确认无误后，可以手动运行 Tidy Footnotes。

请我喝杯咖啡

Better Footnote 永久免费。如果它为你的学术写作省下了时间，欢迎在 Ko-fi 上请我喝一杯咖啡。

语言

插件界面会优先跟随 Obsidian 语言，其次跟随系统语言，最后回退到英文。当前包含英文、中文、日文和韩文界面文案。

日本語

Better Footnote は、Obsidian の脚注サイドバー作業スペースです。長いノート、論文、研究メモで使う脚注を右サイドバーにまとめ、脚注の追加、編集、検索、展開、削除、そして本文中の脚注マーカー、サイドバーのカード、文末の脚注定義の間の移動をしやすくします。

使い方

1. Obsidian の Community plugins から Better Footnote をインストールして有効化します。
2. サイドバーを開く: Obsidian 左側のリボンにあるこのアイコンをクリックするか 、コマンドパレットで Open Better Footnote を実行します。
3. [^1]: Reference text や [^citation]: Reference text のような標準脚注定義を含む Markdown ノートを開きます。
4. 右サイドバーで脚注を編集または検索します。検索欄の横の + で新しい脚注も追加できます。変更は自動保存されます。

なぜ使うのか

Obsidian の脚注記法は柔軟ですが、長いノート、論文、研究下書きでは脚注が増えるほど作業の流れを止めやすくなります。

• 本文中の脚注マーカーと文末の脚注定義が離れていることが多い。
• 脚注を修正するたびに文末へ移動し、また本文へ戻る必要がある。
• 既出の文献や表現を探すとき、全文検索では本文中の一致も混ざってしまう。
• 長い脚注は展開して読みたい一方、短い脚注はコンパクトに保ちたい。
• 脚注を削除するとき、本文中の参照マーカーと文末定義の両方を処理する必要がある。
• 脚注定義（[^4]: など）を手で入力するには手間がかかり、日本語入力では括弧やコロンが全角になって、見た目は正しくても脚注として認識されないことがある。
• 新しい脚注を入れた後、番号や定義順の整理が必要になることがある。

Better Footnote は、脚注をノート末尾に隠れたテキストではなく、右サイドバーの安定した編集作業スペースとして扱えるようにします。

対応する脚注

Better Footnote は標準的な Markdown 脚注定義を中心に対応しています。

本文中の脚注。[^1]
本文中の名前付き脚注。[^citation]

[^1]: 脚注本文。
[^citation]: 名前付き脚注本文。
    続くインデント行は同じ脚注に含まれます。

[^citation] のような名前付き脚注 id にも対応しています。サイドバーには実際の id が表示されますが、Obsidian の閲覧モードでは通常の脚注番号の流れに含めて数字で表示される場合があります。

^[inline text] のような inline footnotes はサイドバーから編集できません。

コードブロック、インラインコード、%% コメント、HTML コメント、$$ 数式、プロパティ欄の中に書かれた脚注記法はただの文字として扱います。カードは作られず、脚注の編集や削除でも変更されません。

基本の流れ

• 本文中の [^id] マーカーをクリックすると、サイドバーの対応する脚注カードが選択されます。
• サイドバーの脚注カードをクリックすると、本文中の対応する脚注マーカーへ移動し、短時間アウトライン表示します。本文にまだ参照がないカードをクリックしても、本文は動きません。
• 文末の脚注定義内にカーソルを置くと、サイドバーでも同じ脚注が選択されます。
• サイドバーで脚注を直接編集できます。変更は Markdown ファイルへ自動保存されます。
• Better Footnote を表示しているときに新しい脚注を挿入すると、カーソルがそのカードに移るので、挿入コマンドが開く小さなウィンドウではなくカードに内容を書きます。小さなウィンドウで書きたい場合は、脚注を挿入する間 Better Footnote のタブを閉じてください。

サイドバーには現在のノート内の実際の [^id] が表示され、脚注定義の順序で並びます。本文中に参照がない定義には「未参照」と表示します。

サイドバーにほかのタブも置いている場合は、設定で 参照マーカーのクリックで Better Footnote に切り替え をオンにしてください。本文の参照マーカーをクリックすると、開いているサイドバーが Better Footnote に切り替わり、その脚注を表示します。Better Footnote のタブをサイドバー内の独立した区画へドラッグして、ほかのタブと同時に表示することもできます。

Tidy Footnotes 連携

Tidy Footnotes をインストールすると、設定で「新しい脚注の後に自動整理」をオンにできます。

• 新しい脚注を挿入すると、Better Footnote が Tidy Footnotes を実行し、新しい脚注が正しい番号と位置に収まります。同期やスクリプトで増えた脚注はハイライトのみです。
• 脚注を削除しても整理はしません。そのため、取り消しを 1 回するだけで元に戻せます。必要なときは Tidy Footnotes を自分で実行してください。
• この連携は Better Footnote を開いているときに働きます。

先に書いて後で置く

脚注は、置く場所を決める前に書いておけます。検索欄の横の + を押すと、最後の脚注定義の後に次の番号の空の脚注が追加され、そのカードがすぐ編集状態になります。置く場所が決まったら、カードの番号をクリックして参照マーカー（例: [^41]）をコピーし、本文に貼り付けます。番号のクリックはコピーだけで、本文もカーソルも動かないので、そのまま貼り付けられます。カードの右クリックメニューからもコピーできます。

本文に置くまではカードに「未参照」と表示され、クリックしても本文は動きません。+ は検索欄が空のときに表示されます。

複数参照

同じ脚注 id が本文中に複数回出てくる場合でも、脚注定義は 1 件なので、Better Footnote はサイドバーに 1 枚のカードだけを表示します。そのカードには参照数が表示され、選択すると前/次ボタンで本文中の各参照マーカーへ循環移動し、移動先を短時間ハイライトします。

これは [^citation] のような名前付き id にも、繰り返し使われた [^1] のような数字 id にも対応します。この機能は位置移動だけを行い、本文の変更、番号整理、Tidy Footnotes の実行は行いません。

脚注検索

サイドバーの検索欄は脚注だけを検索します。脚注番号、id、本文で絞り込めるため、本文中の同じ語句に邪魔されません。

探したい脚注番号または名前が分かっている場合は、先頭に ^ を付けるとその脚注だけに直接絞り込めます。たとえば、^42 は脚注 42 だけを、^citation は脚注 citation だけを対象にします。通常の 42 はこれまでどおり、脚注番号、id、脚注本文を検索します。

スペースで区切った語句は別々に検索され、それぞれハイライトされます。複数の語をひと続きの語句として検索するには、"Hey Jude" のように二重引用符で囲みます（中国語の引用符 “ ” も使えます）。スペースを入れずに書いた日本語や中国語は、もともと入力したとおりの並びで検索されます。

同じ語句が同じ脚注に複数回出る場合も、それぞれ別の一致として数えます。前/次ボタンを押すと該当する一致箇所へ移動します。必要な場合は長い脚注を自動で展開し、脚注エディタ内の一致テキストを選択するため、どこに一致したか確認できます。

検索をクリアすると、検索によって自動展開された脚注はコンパクト表示に戻ります。

長い脚注とカウント

長い脚注は通常コンパクトに表示し、内容が実際に隠れている場合だけ展開ボタンを表示します。短い脚注が不要にスペースを取ることはありません。

各脚注のフッターにはリアルタイムのカウントが表示されます。自動モードでは、英語 UI は単語数、中国語・日本語・韓国語 UI は文字数を数えます。執筆言語が UI と異なる場合は、設定で文字数または単語数に固定できます。

Markdown レンダリング（オプション）

初期状態では、脚注カードは Markdown ソースを編集ボックスで表示します。脚注にリンクや書式付きテキストが多い場合は、設定で「サイドバーで Markdown をレンダリング」を有効にできます。

有効にすると、編集していない脚注カードは、リンク、太字、斜体、内部リンクなどを含むレンダリング済みの Markdown で表示されます。リンクをクリックするとそのまま開き、[[内部リンク]] はワークスペース内で開きます。それ以外の本文をクリックすると編集に切り替わり、カードはその場で埋め込みライブプレビューエディタになります。入力中も書式はレンダリングされたまま、カーソル付近の Markdown 記法だけが展開されます。カーソルはクリックした位置の近くに置かれます。（既知の制限：Ctrl/Cmd+B などのエディタホットキーはカード内では反応しません。代わりに Markdown 記法を直接入力してください。）ノート本文をクリックするか Esc を押すと保存され、レンダリング表示に戻ります。編集中に他のアプリへ切り替えても編集状態は保持されます。ライブプレビューエディタが利用できない場合は、自動的にソース編集ボックスへ戻ります。

この設定は初期状態でオフです。カウントは常に Markdown ソースを基準とします。

脚注の削除

サイドバーの脚注カードを右クリックし、「この脚注を削除」を選びます。確認後、Better Footnote は本文中の参照マーカーと脚注定義を 1 回の編集操作として削除します。同じ番号の定義が二つある場合は、右クリックしたカードの定義だけを削除し、本文の参照マーカーはもう一方の定義に残します。

取り消すには、ノート編集欄をクリックしてから、macOS では Command+Z、Windows/Linux では Ctrl+Z を押します。複数回の取り消しは Obsidian 標準の編集履歴に従います。Better Footnote は削除後に番号を自動整理しません。必要なタイミングで Tidy Footnotes を手動実行してください。

サポート

Better Footnote は無料で、今後も無料のままです。学術的な執筆の時間短縮に役立ったら、Ko-fi でコーヒーを一杯ごちそうしていただけると嬉しいです。

言語

UI は Obsidian の言語、次にシステム言語を参照し、最後に英語へフォールバックします。英語、中国語、日本語、韓国語の UI 文言を含みます。

한국어

Better Footnote는 Obsidian용 각주 사이드바 작업 공간입니다. 긴 노트, 논문, 연구 초안의 각주를 오른쪽 사이드바에 모아 두고, 각주를 직접 추가, 편집, 검색, 펼치기, 삭제할 수 있으며 본문 각주 표시, 사이드바 카드, 문서 끝의 각주 정의 사이를 빠르게 오갈 수 있습니다.

빠른 시작

1. Obsidian Community plugins에서 Better Footnote를 설치하고 활성화합니다.
2. 사이드바 열기: Obsidian 왼쪽 리본에 있는 이 아이콘을 클릭하거나 , 명령 팔레트에서 Open Better Footnote를 실행합니다.
3. [^1]: Reference text 또는 [^citation]: Reference text 같은 표준 각주 정의가 포함된 Markdown 노트를 엽니다.
4. 오른쪽 사이드바에서 각주를 편집하거나 검색합니다. 검색창 옆의 +로 새 각주를 추가할 수도 있습니다. 변경 사항은 자동 저장됩니다.

왜 필요한가

Obsidian의 각주 문법은 유연하지만, 긴 노트, 논문, 연구 초안에서는 각주가 많아질수록 작성 흐름을 끊기 쉽습니다.

• 본문 각주 표시와 문서 끝의 각주 정의가 멀리 떨어져 있는 경우가 많습니다.
• 각주를 고칠 때마다 문서 끝으로 이동한 뒤 다시 본문으로 돌아와야 합니다.
• 이미 인용한 문헌이나 표현을 찾을 때 전체 검색을 하면 본문 검색 결과가 함께 섞입니다.
• 긴 각주는 펼쳐서 보고 싶지만, 짧은 각주는 간결하게 유지하고 싶습니다.
• 각주를 삭제할 때 본문 참조 표시와 각주 정의를 모두 처리해야 합니다.
• [^4]: 같은 각주 정의를 직접 입력하려면 여러 단계가 필요하고, 괄호나 콜론 하나만 틀려도 각주로 인식되지 않습니다.
• 새 각주를 넣은 뒤 번호와 각주 정의 순서를 정리해야 할 때가 있습니다.

Better Footnote는 각주를 문서 끝에 숨어 있는 텍스트가 아니라 오른쪽 사이드바의 안정적인 편집 작업 공간으로 바꿉니다.

지원하는 각주

Better Footnote는 표준 Markdown 각주 정의를 중심으로 지원합니다.

본문의 각주 표시.[^1]
본문의 이름 있는 각주 표시.[^citation]

[^1]: 각주 내용.
[^citation]: 이름 있는 각주 내용.
    이어지는 들여쓰기 줄은 같은 각주에 포함됩니다.

[^citation] 같은 이름 있는 각주 id도 지원합니다. 사이드바에는 실제 id가 표시되지만, Obsidian 읽기 모드에서는 일반 각주 번호 흐름에 포함되어 숫자로 표시될 수 있습니다.

^[inline text] 형식의 inline footnotes는 사이드바에서 편집할 수 없습니다.

코드 블록, 인라인 코드, %% 주석, HTML 주석, $$ 수식, 속성 영역 안에 쓴 각주 문법은 일반 텍스트로 취급합니다. 카드가 만들어지지 않으며 각주를 편집하거나 삭제해도 바뀌지 않습니다.

기본 흐름

• 본문의 [^id] 각주 표시를 클릭하면 사이드바의 해당 각주 카드가 선택됩니다.
• 사이드바 각주 카드를 클릭하면 본문의 해당 각주 표시로 이동하고 짧게 윤곽선을 표시합니다. 아직 본문에 참조가 없는 카드를 클릭하면 본문은 그대로 있습니다.
• 문서 끝의 각주 정의 안에 커서를 두면 사이드바에서도 같은 각주가 선택됩니다.
• 사이드바에서 각주 내용을 직접 편집할 수 있습니다. 변경 사항은 Markdown 파일에 자동 저장됩니다.
• Better Footnote가 표시된 상태에서 새 각주를 삽입하면 커서가 그 카드로 이동하므로, 삽입 명령이 여는 작은 창이 아니라 카드에 내용을 작성합니다. 작은 창에서 작성하려면 각주를 삽입하는 동안 Better Footnote 탭을 닫아 두세요.

사이드바는 현재 노트의 실제 [^id]를 표시하고 각주 정의 순서대로 보여줍니다. 본문 참조가 없는 정의는 “참조 없음”으로 표시합니다.

사이드바에 다른 탭도 두고 있다면 설정에서 참조 표시를 클릭하면 Better Footnote로 전환을 켜세요. 본문의 참조 표시를 클릭하면 열려 있는 사이드바가 Better Footnote로 전환되어 그 각주를 보여 줍니다. Better Footnote 탭을 사이드바의 별도 칸으로 끌어다 놓아 다른 탭과 함께 보이게 할 수도 있습니다.

Tidy Footnotes 연동

Tidy Footnotes를 설치하면 설정에서 "새 각주 뒤 자동 정리"를 켤 수 있습니다.

• 새 각주를 삽입하면 Better Footnote가 Tidy Footnotes를 실행해, 새 각주가 올바른 번호와 위치를 갖게 됩니다. 동기화나 스크립트로 들어온 각주는 강조 표시만 합니다.
• 각주를 삭제해도 정리하지 않으므로 실행 취소 한 번으로 그대로 되돌릴 수 있습니다. 필요하면 Tidy Footnotes를 직접 실행하세요.
• 이 연동은 Better Footnote가 열려 있을 때 작동합니다.

먼저 쓰고 나중에 배치

각주는 넣을 위치를 정하기 전에 먼저 써 둘 수 있습니다. 검색창 옆의 +를 누르면 마지막 각주 정의 뒤에 다음 번호의 빈 각주가 추가되고, 카드가 바로 편집 상태가 됩니다. 넣을 위치가 정해지면 카드의 번호를 클릭해 참조 표시(예: [^41])를 복사한 뒤 본문에 붙여 넣으세요. 번호 클릭은 복사만 하며 본문과 커서는 그대로이므로 바로 붙여 넣을 수 있습니다. 카드의 오른쪽 클릭 메뉴에서도 복사할 수 있습니다.

본문에 넣기 전까지 카드는 “참조 없음”으로 표시되고, 클릭해도 본문은 움직이지 않습니다. +는 검색창이 비어 있을 때 표시됩니다.

여러 참조

같은 각주 id가 본문에 여러 번 나타나도 문서 끝의 각주 정의는 하나이므로, Better Footnote는 사이드바에 카드 하나만 표시합니다. 이 카드에는 참조 수가 표시되며, 카드를 선택하면 이전/다음 버튼으로 본문의 각 참조 표시를 순환 이동하고 해당 위치를 짧게 강조합니다.

이 기능은 [^citation] 같은 이름 있는 id와 반복해서 사용된 [^1] 같은 숫자 id 모두에 적용됩니다. 위치 이동만 처리하며 본문 수정, 번호 정리, Tidy Footnotes 실행은 하지 않습니다.

각주 검색

사이드바 검색창은 각주만 검색합니다. 각주 번호, id, 내용으로 필터링할 수 있어 본문에 있는 같은 단어에 방해받지 않습니다.

찾으려는 각주 번호나 이름을 정확히 알고 있다면 앞에 ^를 붙여 해당 각주만 바로 찾을 수 있습니다. 예를 들어 ^42는 각주 42만, ^citation은 각주 citation만 일치시킵니다. 일반적인 42 입력은 기존처럼 각주 번호, id, 각주 내용을 검색합니다.

공백으로 나눈 여러 단어는 따로 검색되고 따로 강조됩니다. 여러 단어를 한 구절로 검색하려면 "헤이 주드"처럼 큰따옴표로 묶으세요(중국어 따옴표 “ ”도 됩니다). 띄어쓰기 없이 입력한 중국어와 일본어는 원래 입력한 순서 그대로 검색됩니다.

같은 단어가 한 각주 안에 여러 번 나오면 각각 별도의 일치 항목으로 계산합니다. 이전/다음 버튼을 누르면 해당 일치 항목으로 이동합니다. 필요한 경우 긴 각주를 자동으로 펼치고, 각주 편집기 안의 일치 텍스트를 선택해 정확한 위치를 보여줍니다.

검색을 지우면 검색 때문에 자동으로 펼쳐졌던 각주는 다시 간결한 표시로 돌아갑니다.

긴 각주와 계산

긴 각주는 기본적으로 간결하게 표시되며, 실제로 내용이 잘릴 때만 펼치기 버튼을 보여줍니다. 짧은 각주가 불필요하게 공간을 차지하지 않습니다.

각 각주의 하단에는 실시간 계산 값이 표시됩니다. 자동 모드에서는 영어 UI는 단어 수, 중국어·일본어·한국어 UI는 글자 수를 셉니다. 작성 언어가 UI 언어와 다르면 설정에서 글자 수 또는 단어 수로 고정할 수 있습니다.

Markdown 렌더링(선택)

기본적으로 각주 카드는 Markdown 소스를 편집 상자로 표시합니다. 각주에 링크나 서식 있는 텍스트가 많다면 설정에서 "사이드바에서 Markdown 렌더링"을 켤 수 있습니다.

켜면 편집 중이 아닌 각주 카드가 링크, 굵게, 기울임, 내부 링크 등 서식을 포함한 렌더링된 Markdown으로 표시됩니다. 링크를 클릭하면 바로 열리고, [[내부 링크]]는 작업 공간에서 열립니다. 다른 텍스트를 클릭하면 편집으로 전환됩니다. 카드가 그 자리에서 내장 라이브 프리뷰 편집기로 바뀌어, 입력하는 동안에도 서식은 렌더링된 채 유지되고 커서 주변의 Markdown 문법만 펼쳐집니다. 커서는 클릭한 위치 근처에 놓입니다. (알려진 제한: Ctrl/Cmd+B 같은 편집기 단축키는 카드 안에서 동작하지 않으므로 Markdown 문법을 직접 입력해 주세요.) 노트 본문을 클릭하거나 Esc를 누르면 저장되고 렌더링 표시로 돌아갑니다. 편집 중 다른 앱으로 전환해도 편집 상태가 유지됩니다. 라이브 프리뷰 편집기를 사용할 수 없는 경우에는 자동으로 소스 편집 상자로 돌아갑니다.

이 설정은 기본적으로 꺼져 있습니다. 글자 수/단어 수는 항상 Markdown 소스를 기준으로 계산됩니다.

각주 삭제

사이드바의 각주 카드를 오른쪽 클릭하고 “이 각주 삭제”를 선택합니다. 확인하면 Better Footnote가 본문 참조 표시와 각주 정의를 하나의 편집 작업으로 함께 삭제합니다. 같은 번호의 정의가 두 개 있으면 오른쪽 클릭한 카드의 정의만 삭제하고, 본문의 참조 표시는 다른 정의에 남겨 둡니다.

되돌리려면 노트 편집 영역을 클릭한 뒤 macOS에서는 Command+Z, Windows/Linux에서는 Ctrl+Z를 누르세요. 여러 번 되돌리기는 Obsidian의 일반 편집 기록을 따릅니다. Better Footnote는 삭제 후 번호를 자동으로 정리하지 않습니다. 필요할 때 Tidy Footnotes를 직접 실행하세요.

후원

Better Footnote는 무료이며 앞으로도 무료입니다. 학술 글쓰기에 도움이 되었다면 Ko-fi에서 커피 한 잔으로 응원해 주세요.

언어

UI는 먼저 Obsidian 언어, 다음으로 시스템 언어를 따르며, 마지막으로 영어로 돌아갑니다. 영어, 중국어, 일본어, 한국어 UI 문구가 포함되어 있습니다.

Development

This repository keeps the reviewed source and release artifact in the same plain main.js file.

npm test
node -c main.js