Obsidian の vault を静的サイト化する

Obsidian vault を Quartz v5 で静的 HTML 化 → Cloudflare Pages で公開する型 (vault-site)。wikilink・バックリンク・グラフ・タグページ・全文検索・ダーク/スマホ対応が標準で付く。

  • v5 はプラグイン非同梱github:quartz-community/...ビルド前に取得する npx quartz plugin install --from-config が必須(v4 は同梱で不要)。設定は quartz.config.yaml(v4 は .ts)。
  • content/ が vault。サイトのトップは content/index.mdホームMOC を index.md にリネームし、 被リンク [[ホーム]] は frontmatter aliases: [ホーム]alias-redirects プラグインで解決。
  • wikilink の basename 解決crawl-linksmarkdownLinkResolution: shortest で、サブフォルダを 跨いでも「ノート名だけの wikilink」がそのまま繋がる。
  • 日本語の全文検索:v5 の検索エンコーダは CJK を1文字ずつトークナイズこんにちは→各文字)。 日本語クエリでヒットする(FlexSearch 素のままだと取りこぼす領域なので、v5 が対応済みなのが効く)。
  • デプロイnpx wrangler pages deploy public --project-name <名>CLI 直アップロードで git remote 不要。 認証は CLOUDFLARE_API_TOKENwrangler login。初回は wrangler pages project create が要る場合あり。
  • ビルドは npx quartz build/ローカルプレビューは npx quartz build --servequartz serve は無い)。

出典:vault-site。コンテナ事情の土台は 9pマウントはgitリポジトリを持てない