Tools
Docs フレームワーク比較 (fumadocs 代替)
Docusaurus / Nextra / Astro Starlight / Quartz / VitePress / MkDocs Material の得意分野と、fumadocs から乗り換える価値
要点: 個人メモ用途なら fumadocs で足りてる。「versioning」「blog テーマ」「i18n」「backlink/graph」等の具体的欠落がある時だけ他へ乗り換え検討。移行の実コストは markdown 移植ではなくテーマ CSS 全書き直し。
主要フレームワーク
| Framework | 派閥 | 強み | 弱み |
|---|---|---|---|
| fumadocs | Next.js | モダン UI、Twoslash 標準、MDX 豊富、静的 export | ブログ・versioning 弱い |
| Docusaurus | Meta | 最大手、versioning・blog・i18n・Algolia 内蔵 | 見た目古め、重い |
| Nextra | Vercel 系 | fumadocs 近い、blog テーマ選択可 | fumadocs と差別化薄い |
| Astro Starlight | Astro | Islands で高速、i18n 内蔵、拡張性 | Next.js エコシステムと薄い |
| Quartz | Obsidian 系 | backlink・graph view、Obsidian 互換 | Docs より Wiki 寄り |
| VitePress | Vue | 高速・シンプル | 機能絞ってる |
| MkDocs Material | Python | 老舗・プラグイン超豊富・i18n | 見た目が古典 |
fumadocs にない / 弱い機能
| 機能 | 用途 | 持ってる framework |
|---|---|---|
| Versioning | v1/v2 doc 分離 | Docusaurus, Starlight |
| Blog テーマ | 日付・タグ・著者付き投稿 | Docusaurus, Nextra |
| i18n | 多言語切替 | Docusaurus, Starlight, MkDocs |
| Comments | 記事コメント (Giscus 等) | 標準ではどれも別途 (Docusaurus が組みやすい) |
| Backlinks / Graph | Obsidian 的な相互参照可視化 | Quartz のみ |
| Algolia DocSearch | 高品質検索 | Docusaurus 標準 |
| Rich plugin ecosystem | あれもこれも | Docusaurus, MkDocs |
fumadocs が既に持ってるもの
- MDX + カスタム component 豊富 (Card / Callout / Steps / Tabs / Files / TypeTable / ImageZoom)
- Twoslash (TS 型 hover)
- Mermaid・KaTeX (プラグインで有効化、実装済)
- Orama 検索 (client-side)
- OG 画像自動生成
- llms.txt / llms-full.txt (AI エージェント向け全文ダンプ)
- 静的 export (Cloudflare Pages で回る)
- ダークモード・レスポンシブ・PWA 化容易
- Autolink headings、last updated (git 由来)
移行コスト
- markdown コンテンツ: ほぼそのまま (frontmatter 微調整のみ)
- テーマ・UI: 全書き直し (今日の緑アクセント・Noto JP・home page 等はやり直し)
- plugin 依存: framework ごとにエコシステム異なる、多くは同等品ある
工数目安:
- Docusaurus / Nextra / Starlight 移行: 数日
- Quartz 移行: 半日 (シンプル)
判断基準
乗り換えるべき状況:
- backlink / graph が欲しい → Quartz
- 多言語 で書きたい → Docusaurus / Starlight
- 時系列ブログとして最新投稿を目立たせたい → Nextra (blog theme) or Docusaurus
- バージョニング が要る → Docusaurus (個人メモには基本不要)
- fumadocs の見た目・エコシステムが合わない → Nextra / Starlight
留まるべき状況:
- 個人メモ + 技術メモ用途
- 現在の見た目に満足
- 追加したい機能が「なくても困らない」レベル
Pragmatic path
fumadocs で足りないと感じるまで待つ。具体的な欠落が出たらそれに合う framework へ pinpoint 移行。今の投資 (auto-deploy, MCP, カスタム UI) を捨てる意味は薄い。
「〜っぽくしたい」レベルなら fumadocs 上での自作 (プラグイン追加・component 増設) で大半対応可能:
- backlink → MDX 内で手書きリンク + 全文検索
- タグ → frontmatter に
tags: [...]追加 + タグ一覧ページ自作 - 最新投稿一覧 → home page を mtime ソート表示に改造 (今日やった)
関連
最終更新: