Backlink と Graph view

ノート間の相互参照を可視化する機能 (被リンク一覧 + ネットワーク図)。Obsidian が標準搭載、fumadocs は自作で足す

要点: Backlink = 「このノートを参照してる他ノート一覧」を自動表示、Graph view = ノート同士のリンク網を視覚化。Obsidian・Roam・Logseq が標準搭載。fumadocs は自作で足せる (半日〜1 日)。

Backlink とは #

「A → B を link」書いた時、B のページに「A から参照されている」と自動表示される。単方向リンクを双方向で見える化。

例:

ff-stack.md に [gs_usb タイムスタンプ](/docs/robotics/gs-usb-timestamp) と書く
gs-usb-timestamp.md を開くと下部に自動で「Linked from: ff-stack, latency-measurement, pid-ff-autotune」

利点: あるトピックの言及箇所を一望、忘れてた関連に気づける。

Graph view とは #

ノード = note、エッジ = link のネットワーク図。

見えること:

クラスター = 関連トピック群 (control 系がまとまってる等)
孤立ノート = 誰からも参照されない
ハブノート = 多くから参照される中心

標準搭載アプリ #

ツール	Backlink	Graph
Obsidian	✅	✅
Roam Research	✅	✅
Logseq	✅	✅
Notion	✅ (双方向 mention)	❌
Quartz (静的サイト)	✅	✅
fumadocs	❌ (自作要)	❌ (自作要)
Docusaurus	❌	❌

fumadocs で自作する場合 #

Backlink 実装 (~100 行、半日)#

Build 時に:

source.getPages() で全 page 走査
各 page の body を parse → /docs/... link を抽出
Map<targetSlug, sourcePage[]> 構築
Page component で backlinks[currentSlug] を末尾に表示

// lib/backlinks.ts
export function buildBacklinkMap(source) {
  const map = new Map<string, Set<string>>();
  for (const page of source.getPages()) {
    const links = extractInternalLinks(page.data.body);
    for (const target of links) {
      if (!map.has(target)) map.set(target, new Set());
      map.get(target).add(page.url);
    }
  }
  return map;
}

Graph view 実装 (~200-300 行、1 日)#

Backlink の link map を JSON dump → /graph ページで可視化。

D3.js (力学モデル、細かく制御可)
cytoscape.js (グラフ描画に特化、簡単)
vis-network (シンプル、少量ノード向き)

100 ノートくらいまではブラウザで滑らか。

深い階層構造は fumadocs で対応済 #

content/docs/
├── robotics/
│   ├── actuators/
│   │   ├── motors/
│   │   │   ├── robomaster.md
│   │   │   └── m3508.md
│   │   └── servos/
│   └── sensors/
│       └── depth-cameras/
│           └── d455.md

サイドバーが自動ネスト
各階層に meta.json で順序制御可
実運用は 2-3 階層まで推奨 (URL 長くなる)

選択肢 #

選択	コスト	得るもの	失うもの
A: 階層深化のみ	0	分類の細かさ	なし
B: backlink 自作	半日	相互参照可視	なし
C: B + graph 自作	1 日	ネットワーク図	なし
D: Obsidian 併用 (authoring 用)	インストール	ローカルで graph・backlink	Obsidian と fumadocs の記法差
E: Quartz 移行	1-2 日	全部標準	fumadocs UI・plugin 資産

推奨 #

A + B の組み合わせ:

階層深化 (今日、コスト 0)
backlink 自作 (半日、既存 UI 保持)

Graph view (C) は "あれば楽しい" レベルで優先度低め。ノートが 30 個超えてから検討で十分。

D の Obsidian 併用: PC で書く時のサポートツールとしては悪くない (mobile obsidian + git 連携で外出先でも書ける)。公開は fumadocs のまま。