Publishing these notes

Publishing these notes

I use Obsidian to write these notes, and Blot to publish them. I have a private git repo for all my notes public and private, and the notes that get published on this website are a submodule in that larger git repo (the submodule is the git repo blot provides for syncing).

I use the Obsidian Git plugin to automatically push content to the website, so when a file is edited or moved to the submodule, the plugin will push that content to the website at some interval.

I use Working Copy to sync the repo to a local folder on my iOS devices that the Obsidian mobile app can use as a vault.

Alternatives

I wanted a system that could do the following:

Publish new notes easily

Have some form of a blog post style, where recent posts can be made more visible

Handle wikilinks

Display backlinks

Simple management

For now, this works well for these purposes. A couple alternatives I’ve tried or considered:

A more standard static site generator: Hugo, Jekyll, 11ty, etc.

Obsidian Publish is quite good, but I’ve found the out-of-the-box CSS from Blot to be closer to what I’m looking for.

Despite that, a couple things that Obsidian Publish does better than Blot:

Proper handling of dead links (i.e. links to notes that have not yet been created)

A local graph view displaying the connections from one note to other notes

Robustness

For now, this process feels relatively robust.

I really don’t want to get too stuck in the tinkering and development of the system, and allow myself to focus more on the writing and content creation. I have tendency to be easily dissatisfied with UI/UX, and a tendency to tinker and try to over-optimize (very related to my background as a developer I’m sure). For this reason, it is a priority to have something that “just works”, as much as that is possible.

I still want to make lots of changes to the CSS I’m using on this site, and may switch away from Blot to something else in the future. But for now this system has given me the most peace of mind, and I’ve found myself writing and not worrying about the process of publishing knowing that it is working pretty well, which is great.

Pre-notes

I use Apple’s Notes and Reminders apps to take down quick ideas before processing them into the my Obsidian notes. Since I use pretty much all Apple devices, I’ve found this to be a good way to take down quick ideas or things I want to remember.

This allows me to jot down ideas while away from home with my phone (with or without internet access), provides an easy place to throw quick thoughts without needing to organize them, and allows me to speak to a HomePod while at home or speak to Siri in a car if I don’t want to get out a device.