Skip to content

Re-Building my blog again

I took the opportunity in my break to try and play with some tools that better
suited my blogging / notes style. I found TiddlyWiki which is a very good tool,
however the writing experience for TiddlyWiki is quite bad. I had to let it go.

Since then I looked at a bunch of different tools and settled at
FoamBubble for my notes and
Mkdocs for the generating the blog. Will talk about
the setup below and my rationale for not writing another blogging tool.

What do I want ?

I want to write my notes in VsCode. I am not going to use any other tool for
this. I tried using Obsidian, but i kept forgetting that Obsidian was running
and I would end up wriitng notes in Markdown on VsCode itself. This felt like a
signal from the universe.

Apart from this I do not want to write custom markdown for my static-site-generator.

I also really like wiki like links [[like this]] and foam + some plugins etc
just make it work. So I get the same experience on the blog and on my local
computer. I just live in my editor, my terminal and the browser. I am a happy man.

Foam ?

You should check it out if you are in the market for a system that just work.
Foam lets me writes and gets the fuck out of way. I dont even know what all
features it has because honestly I dont care and I dont need them.

Thats how cool foam is. I get to write templates, I see a list of tags,
link-autocomplete, thats it. What else does a man need ?

And what about MkDocs ?

Mkdocs is a very popular documentation generator. It eats markdown and spits out
HTML. There is a rich ecosystem of plugins and themes which makes writing a
blog using markdown a breeze.

There are plugins which lets Mkdocs understand wiki-style links and that really
helps with the whole flow because now I dont have to convert my links to be
mkdocs compatible. I do think that the makrdown native link format is shit. Anyway.

I did have to re-write some of the templates that mkdocs uses. This and a
pythong program that I (and Claude) wrote to link my notes to the ssg. The core
functionality is very simple; look at all of my notes which are public, export
these and ONLY export images / assets linked from these notes. It is linked
here. Do not show it any love.

So far this process has been very very seamless. I even migrated all of my other
notes here which is working fabulously.

Added bells and whistles ?

In the new site there is a search functionality, which is something I really like.