Marktmannen wiki Personal Knowledge Management (PKM)

Obsidian-vault publiceren met Quartz

Laatst bijgewerkt: 20-07-2026

TL;DR: Quartz is een gratis, open-source static site generator (winnaar Obsidian "Best Tool" Gems of the Year 2023) waarmee je een Obsidian-vault als website publiceert — meestal op GitHub Pages — als alternatief voor het betaalde Obsidian Publish; het grootste aandachtspunt is het filteren van privécontent vóór publicatie.

Publiceren van Markdown-notities bestaat uit drie componenten: (1) de editor die Markdown maakt (Obsidian), (2) de static site generator die Markdown naar HTML omzet (Quartz), en (3) de hosting (GitHub Pages, Cloudflare of Netlify). Obsidian Publish doet alle drie voor $8-20/maand; Quartz vervangt alleen de middelste stap maar is gratis, zelf te hosten en veel verder aan te passen — inclusief wikilinks, backlinks en de bekende graph view.

Wanneer Quartz i.p.v. Obsidian Publish

  • Publish: makkelijkst, zit ín Obsidian, maar betaald, niet zelf te hosten, traag en beperkt aanpasbaar; geen automatiseringspipeline mogelijk.
  • Quartz: gratis, open source, goed gedocumenteerd, past in een CI/CD-pipeline (GitHub Actions), maar vereist comfort met terminal, Git/GitHub en Node/npm.
  • Van der Hoeven gebruikt bewust beide naast elkaar: Publish voor haar hoofdvault, Quartz voor losse publieke projecten — beste tool per use case.

Standaardroute (Van der Hoeven, Quartz 4)

  1. Quartz-repo clonen, npm i, npx quartz create (keuze: lege vault, kopie of symlink van bestaande map).
  2. Nieuwe GitHub-repo aanmaken en als origin koppelen (Quartz zelf blijft upstream); syncen met npx quartz sync.
  3. Dezelfde map als Obsidian-vault openen; content in de content/-map schrijven, eventueel met Templater-templates in het door Quartz verwachte frontmatter-formaat (title, draft, tags).
  4. Lokaal previewen via de ingebouwde buildserver (localhost:8080/1313).
  5. Hosten op GitHub Pages: deploy.yml GitHub Action toevoegen, in repo-settings Pages op "GitHub Actions" zetten; site staat op gebruikersnaam.github.io/reponaam.
  6. Optioneel eigen domein: A-records naar GitHubs IP-adressen + custom domain in Pages-settings, daarna HTTPS afdwingen.

Privécontent-route (Boswell, oudere Hugo-gebaseerde Quartz)

Boswell wilde absoluut geen privénotities online en bouwde daarom een lokale pre-compile-pipeline in plaats van Quartz' eigen GitHub Action: obsidian-export (Rust) filtert de vault op basis van een .export-ignore-bestand in de vault-root (mappen als private/*, people/*, 1-1/*, .obsidian/*) en zet Obsidian-wikilinks om naar standaard Markdown; daarna bouwt hugo-obsidian + Hugo de site, en alleen de gecompileerde public/-map gaat naar GitHub Pages. Kernprincipe: filter privébestanden zo vroeg mogelijk in de pipeline, zodat ze nooit in de geparste map (laat staan de repo) terechtkomen. Let op: dit artikel beschrijft de oudere Quartz 3/Hugo-architectuur; Quartz 4 (de route hierboven) is een standalone Node-tool zonder Hugo.

Relevantie voor eigen kennisbank

Dit is de publicatielaag bovenop een Zelfverbeterende Kennisbank: de wiki-map is al Markdown met wikilinks, dus een static site generator als Quartz kan die direct als digital garden serveren. Het .export-ignore-principe (whitelist/blacklist vóór de build) is het spiegelbeeld van de cockpit-regel om klantdata nooit mee te publiceren.

Open vragen

  • Hoe verhoudt Quartz zich tot een buildless conversie-aanpak (geen Node-toolchain, direct HTML genereren) voor een wiki die achter toegangsbeheer (bv. Cloudflare Access) staat?
  • Ondersteunt Quartz 4 inmiddels selectieve publicatie (ignore-patronen) native, zodat de obsidian-export-voorbewerking overbodig is?

Verwante concepten

Bronnen

#quartz #obsidian #publiceren #github-pages #digital-garden #static-site-generator

Backlinks