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 にリネームし、 被リンク[[ホーム]]は frontmatteraliases: [ホーム]+alias-redirectsプラグインで解決。 - wikilink の basename 解決:
crawl-linksのmarkdownLinkResolution: shortestで、サブフォルダを 跨いでも「ノート名だけの wikilink」がそのまま繋がる。 - 日本語の全文検索:v5 の検索エンコーダは CJK を1文字ずつトークナイズ(
こんにちは→各文字)。 日本語クエリでヒットする(FlexSearch 素のままだと取りこぼす領域なので、v5 が対応済みなのが効く)。 - デプロイ:
npx wrangler pages deploy public --project-name <名>。CLI 直アップロードで git remote 不要。 認証はCLOUDFLARE_API_TOKENかwrangler login。初回はwrangler pages project createが要る場合あり。 - ビルドは
npx quartz build/ローカルプレビューはnpx quartz build --serve(quartz serveは無い)。
出典:vault-site。コンテナ事情の土台は 9pマウントはgitリポジトリを持てない