Quartz 4

⚖️ ADR-001: Quartz als Static Site Generator

2 min read

Status: Accepted

Entschieden am 2026-04-21. Aktiv in Verwendung.

📋 Kontext

Für den Aufbau eines persönlichen Digital Gardens wird ein Static Site Generator benötigt, der:

  • Markdown-Notizen verarbeitet
  • Wikilinks ([[...]]) unterstützt
  • Automatische Backlinks generiert
  • Einen Knowledge-Graphen darstellt
  • Mit Obsidian kompatibel ist
  • Einfach zu deployen ist

Es wurde nach einer Lösung gesucht, die keine Server-Infrastruktur erfordert und direkt aus einem Obsidian-Vault speist.

✅ Entscheidung

Quartz 4 wird als Static Site Generator verwendet.

Deployment via Cloudflare Pages auf quartzen.pages.dev.

🔀 Alternativen

Option A: Jekyll

  • ✅ Sehr ausgereift, große Community
  • ✅ GitHub Pages nativ unterstützt
  • ❌ Kein nativer Wikilink-Support
  • ❌ Ruby-Abhängigkeit, langsam
  • ❌ Kein automatischer Backlink-Graph
  • Verworfen: Fehlende Wikilink/Backlink-Unterstützung war K.O.-Kriterium

Option B: Hugo

  • ✅ Extrem schnell
  • ✅ Große Auswahl an Themes
  • ❌ Komplexe Template-Syntax (Go templates)
  • ❌ Wikilinks nur via Plugin (unzuverlässig)
  • ❌ Kein eingebauter Backlink-Graph
  • Verworfen: Zu viel Setup für Obsidian-Kompatibilität

Option C: Obsidian Publish

  • ✅ Perfekte Obsidian-Integration, zero config
  • ✅ Schönes Design, Mobile-optimiert
  • ❌ 8 USD/Monat Abokosten
  • ❌ Kein eigenes Theming/Customizing
  • ❌ Keine volle Kontrolle über Output
  • Verworfen: Kosten + fehlende Kontrolle

Option D: Gatsby + Digital Garden Theme

  • ✅ React-basiert, sehr flexibel
  • ✅ Plugin-Ökosystem
  • ❌ Hohe Komplexität, steile Lernkurve
  • ❌ Langsame Build-Zeiten
  • ❌ Viel Boilerplate für einfache Notizen
  • Verworfen: Overengineering für den Anwendungsfall

Option E: Quartz 4 ← Gewählt

  • ✅ Nativ für Obsidian-Vaults gebaut
  • ✅ Wikilinks, Callouts, Embeds out-of-the-box
  • ✅ Automatische Backlinks + interaktiver Graph (D3)
  • ✅ Full-text Search (FlexSearch)
  • ✅ KaTeX, Mermaid, Syntax-Highlighting
  • ✅ RSS, Sitemap, OG-Bilder
  • ✅ TypeScript-Konfiguration (wartbar)
  • ✅ Kostenlos, Open Source (MIT)
  • ⚠️ Node.js 22+ erforderlich
  • ⚠️ Relativ kleine Community vs. Hugo/Jekyll

📐 Konsequenzen

Positiv:

  • Zero-Config für Obsidian-Workflow
  • Alle gewünschten Features sofort verfügbar
  • Cloudflare Pages Deployment in < 5 Minuten eingerichtet
  • TypeScript-Config erlaubt präzises Anpassen ohne Framework-Kenntnisse

Negativ / Risiken:

  • Kleinere Community → weniger Themes, weniger Hilfe
  • Quartz-spezifische Plugin-API (nicht portabel)
  • Abhängigkeit von jackyzha0 als Hauptentwickler

Neutral:

  • Node 22 muss installiert sein (ohnehin vorhanden)
  • npx quartz build als Build-Befehl ist einfach

🔗 Verwandte Entscheidungen

Entschieden: 2026-04-21 | Reviewer: soberika

Graph View

Backlinks