📓 my-personal-wiki-setup.md by @neil ☆

My personal wiki setup

See also: [[Flock]]. (I should merge these pages?)

I started with just org-mode and org-publish. As of [[March 2020]], I started using org-roam, too.

This has been a nice progression. Using just plain org-mode got me started with minimal effort. Then org-roam has been a great extra layer on top, when I realised I wanted more to follow the [[zettelkasten]]/[[tiddler]] approach of smaller notes linked together. It provides a list of backlinks, as well as basic graphing/visualisation, so it goes some way to helping find the constellations, too.

How it meets my requirements

As per [[My personal wiki requirements]].

Low-friction writing

I am very tied to text-editing in Emacs (with vi bindings), so big win here so far. To be honest I’m not a huge fan of org-mode markup for some reason, it’s a bit ugly in places (I mean #+BEGIN_QUOTE, what the hell kind of syntax is that??), but I’m familiar with it and of course it integrates very nicely into Emacs.

Low-friction connections

org-roam makes it very easy to link between notes.

Finding [[constellations]]

org-roam has backlinks and graphing capability. To be honest, although I’ve kicked the tires, I haven’t made much active use of the sense-making features yet though.

[[org-roam-ui]] adds a lovely graphical layer on top of org-roam.

Publishing capabilities

With org-publish you can pretty easily (requires a bit of [[config]]) output the static HTML. org-roam taught me the nice idea of adding extra hook as well for org-publish, and has one for pulling in all your backlinks. I may switch to ox-hugo at some point, for improved publishing.

See my [[personal wiki config]] for some config bits and pieces.

Plain-text

Yep.

Backed by version control

Yep - I use git.

Local-first

I can write in org and org-roam without any connection. If I want to pull in some links then I need connection, but I can just use the title.

Libre software and longevity

Indeed so. Emacs, org, they’re FOSS++ and have stood the test of time much longer than most. org-roam is a new kid, very active at the moment, but to be seen how long it sticks around. But if org-roam vanished, I’d just lose some features, not all of my thoughts and ideas. All my plain-text would still be right there.

Interwiki linking

I added simple incoming [[webmention]] support to enable comments ([[Receiving webmentions on my digital garden]]).

I syndicate copies of all my pages to [[Anagora]]. ([[2021-11-28]])

Misc

I like this as an approach because it uses and leverages all of the existing functionality of the Emacs ecosystem. I’m not learning a new tool (although of course it was a new tool to me at one point, and I wouldn’t really recommend all this to someone not already familiar with Emacs, it’s a steep learning curve - worth it though!).

Could be improved