Quartz とは
Quartz は、Markdown ノート（特に Obsidian vault）を高速な静的サイトに変換するデジタルガーデン向けの静的サイトジェネレーター (SSG) です。作者は Jacky Zhao。
特徴
- Obsidian との親和性:
[[Wikilink]]記法、バックリンク、埋め込み、タグ、callout などをそのままサポート - 高速ビルド: 数千ノート規模でも数秒〜十数秒でビルド可能
- グラフビュー: ノート間のリンク関係を可視化するインタラクティブなグラフを自動生成
- 全文検索: クライアントサイドで動作する高速検索（FlexSearch ベース）
- SPA ナビゲーション: ページ遷移がスムーズ
- ダーク/ライトテーマ: 標準対応、CSS 変数で簡単にカスタマイズ可能
- 数式・図表: KaTeX、Mermaid を標準サポート
- RSS / sitemap.xml 自動生成
アーキテクチャ
Quartz v4 は TypeScript で書かれており、以下のパイプラインで構成されています：
- Transformers: Markdown を解析し AST に変換（remark/rehype プラグイン群）
- Filters: 公開対象のノートを選別（draft 除外など）
- Emitters: HTML、RSS、検索インデックスなどを出力
各段階はプラグインとして差し替え可能で、quartz.config.ts でカスタマイズします。
主なファイル
| ファイル | 役割 |
|---|---|
quartz.config.ts | サイトタイトル、base URL、プラグイン構成 |
quartz.layout.ts | ヘッダー、サイドバー、フッターのレイアウト定義 |
content/ | Markdown ノート置き場（Obsidian vault としても使える） |
quartz/components/ | カスタマイズ可能な React (Preact) コンポーネント |
よく使うコマンド
# 初期化
npx quartz create
# ローカルプレビュー（ホットリロード付き）
npx quartz build --serve
# 本番ビルド
npx quartz build
# GitHub Pages などへ同期
npx quartz sync競合・類似ツールとの比較
| ツール | 特徴 | Quartz との違い |
|---|---|---|
| Obsidian Publish | 公式・有料（月$10〜） | Quartz は無料・OSS、自前ホスティング |
| Jekyll / Hugo | 汎用ブログ向け SSG | Quartz は wikilink・バックリンクなど Obsidian 特化機能を標準装備 |
| Logseq Publish | Logseq 専用 | Quartz は Markdown ベースで汎用 |
| MkDocs | ドキュメント特化 | Quartz はノート間ネットワークの可視化が強み |
ホスティング
静的ファイルなのでどこでもデプロイ可能：
- GitHub Pages — 無料、
npx quartz syncで push - Cloudflare Pages — CDN 配信が高速
- Netlify / Vercel — ビルドフック対応
こんな人におすすめ
- Obsidian でノートを書いていて、それを そのまま公開したい 人
- ブログよりネットワーク型のナレッジベース（Zettelkasten / Second Brain）を公開したい人
- 自分のノートに全文検索やグラフビューが欲しい人
参考リンク
- 公式サイト: https://quartz.jzhao.xyz/
- GitHub: https://github.com/jackyzha0/quartz
- 作者ブログ: https://jzhao.xyz/
- Discord コミュニティ: 公式サイトから参加可能
このノートについて
このリポジトリでの Quartz テストセットアップの一環として作成。
[[ ]]でリンクされたObsidianノートはまだ存在しないので、リンクをクリックすると新規作成扱いになります。