Scribbles 'n Bits
May 4th, 2024

Publishing my Obsidian Vault with Quartz

I've been using Obsidian for managing my thoughts and notes and references for a few years. I've toyed a few times with using Obsidian Publish to share some of those notes publicly, but I wasn't sure I'd get enough benefit from that to justify the $8/mo subscription just for Publish. 

Plus I'd rather host on a system I control.

Well yesterday I stumbled across Quartz:

Quartz is a fast, batteries-included static-site generator that transforms Markdown content into fully functional websites. 

Hugo, Jekyll, and 11ty are also SSGs which convert Markdown files into functional websites, but Quartz is optimized for the digital garden approach of less-polished posts which can grow and connect together organically. It's a great way to collect (and share) bits of knowledge, and a great complement to how I already work with Obsidian.

So I decided to give Quartz a try, and I'm quite impressed with it so far. You can see what I've got here (keeping in mind that these are very much scribbled "notes to myself" rather than polish blog posts):

This is being served from one of my cloud servers, and is deployed to there through a GitHub Actions workflow I cobbled together for that purpose. That GitHub repo holds a new safe-for-public-consumption Obsidian Vault, and I can publish new notes by simply writing them in Obsidian and then running:

npx quartz sync

That syncs the changes to the repo and fires off the workflow, which builds the site and uses Tailscale SSH to push it to the server.

Neat!