Obsidian and Quartz

2025-04-27

This post is something a little different. Instead of writing about a project that I've made, I'd like to share something that has made it easier to put together my own small works.

There are a lot of options for note-taking software out there. Honestly, I've never really found one that's perfect, but there's a lot of options that I intentionally avoid. OneNote, the Microsoft offering, doesn't come free, and if you're using the cloud version, you don't even have local access to your notes without internet. You could go with something simpler, like Notepad++, which is a great application for working with text files, but then you're giving up a lot of features that make organizing and styling your notes easy.

The best of both worlds: Obsidian. Its primary note format is Markdown, which means if you're familiar with styling stuff for GitHub or README files, then you'll already know how to get the most out of it. It can handle tables, pictures, links, and much more, and you can keep all your files accessible locally. These files are even readable in other editors because, again, it's just Markdown.

I won't go through all the features, but there are a few I'd like to highlight. By using Obsidian's special links between files, you can quickly connect anything related then follow those links or just see previews by hovering over them. This also opens up the world of the graph feature, where you can see how all your notes interconnect. As someone who loves these visuals and who is currently working on a Fire-Emblem-themed D&D campaign, I'm having a blast seeing how all my notes are related and which notes are the most connected.
Graph view of my D&D notes

There are a lot of plugins as well for everything that's not natively included. Some of them are provided by the Obsidian developers, but there's a lot of community support that allows others to write and share their own plugins.

That being said, it doesn't have everything. I'm still unable to move totally to Obsidian because I've yet to find a solution that password protects the entire vault (Obsidian's collection of notes). There are plugins to get local encryption of files, but that's not what I'm looking for.

They'll also try to sell you on their cloud storage as a method of syncing your files across systems, but you can easily avoid that by using any number of file-syncing services.

But the case that I more recently needed was a way to make a vault publicly viewable by anyone with an internet connection. More importantly, they shouldn't have to be tech-savy to do so.

Quartz

Thankfully someone else has addressed this problem. Quartz is a community-built application that takes your Obsidian vault and converts it into a wiki-like website. It's written mostly in TypeScript, so if you're familiar with web development there's nothing stopping you from modifying it to your needs.

It uses a system of components to determine how the page gets populated. By default, there's stuff like a table of contents and graph view, but you can remove what you don't like, and if you're feeling up to it, you can even write your own components.

Best of all, it keeps a lot of the nice features that Obsidian has. All those notes you interconnected previously? Yeah, the links still work and so does the hover preview.

Hover preview of a linked note in Quartz

Now, the final result is just a statically rendered website, so you can host it pretty much anywhere. I chose to go with GitHub Pages, because every time I push a change it can just run a workflow that builds and deploys the new content.

Without any customization of your own, it's going to look a little plain, but don't be discouraged. It's function over form here. That makes it great for documentation pages and blogs.

Purpose

Why am I bothering with all this? Well, the D&D campaign I'm working on has a lot of homebrew material. In order for players to explore all the new items, classes, skills, and other goodies, they can now go straight to a website with all those details.

I've also used it to create an online repository of recipes. My wife and I found that some of our favourite online recipes that we used occasionally disappeared, either because the website got abandoned or they put them behind a paywall. Now, we can have our own recipe vault that we can load recipes onto and access from anywhere.

If you're interested consider checking out the Recipe Vault. Try out some recipes and let me know how they turn out. Obviously, I'd also recommend you check out Obsidian and Quartz to start your own Markdown-fueled website today.