capsule/markdown/publishing-my-obsidian-vault-with-quartz.md

31 lines
1.9 KiB
Markdown
Raw Normal View History

2024-05-04 20:41:11 +00:00
---
title: "Publishing my Obsidian Vault with Quartz"
published: "2024-05-04T20:40:14.000000Z"
updated: "2024-05-04T20:40:14.000000Z"
---
I've been using [Obsidian](https://obsidian.md/) for managing my thoughts and notes and references for a few years. I've toyed a few times with using [Obsidian Publish](https://obsidian.md/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.
2024-05-04 20:40:28 +00:00
Well yesterday I stumbled across Quartz:
> Quartz is a fast, batteries-included static-site generator that transforms Markdown content into fully functional websites.
2024-05-04 20:41:11 +00:00
Hugo, Jekyll, and 11ty are also SSGs which convert Markdown files into functional websites, but Quartz is optimized for the [digital garden](https://jzhao.xyz/posts/networked-thought)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.
2024-05-04 20:40:28 +00:00
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:
- [notes.runtimeterror.dev](https://notes.runtimeterror.dev)
This is being served from one of my cloud servers, and is deployed to there through a [GitHub Actions workflow](https://github.com/jbowdre/notes/blob/a2255ba40561f6754fbefca3d901847f7bb546f5/.github/workflows/deploy.yaml) 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
```
2024-05-04 20:41:11 +00:00
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!
2024-06-19 15:26:06 +00:00
=> https://blog.jbowdre.lol/post/publishing-my-obsidian-vault-with-quartz 📡 Originally posted on jbowdre's weblog