Finally, a blogging setup I like¶
Native blog support recently landed in Material for MkDocs . This is huge, because technical documentation + blog can live in the same place and actually look nice!
For a long time I've been following Martin's work on Material for MkDocs (@squidfunk on ). I've used my fair share of documentation frameworks and tools, but I keep coming back to this one because...
- Simple, with the right set of features focused on technical documentation
- Tooling that just works and looks nice out-of-the-box
- Easy enough to extend and customize. Add CSS, change fonts, modify JS, etc.
- Sane navigation with options to tweak
- Fantastic documentation with a project Philosophy that resonates
- Native blog support
That last one (blog support) was huge for me, for reasons I'll describe in the Writing section.
📣 Announcing blog support— Martin Donath (@squidfunk) September 12, 2022
Insiders 4.23.0 ships long-awaited blogging support via the brand new built-in blog plugin! 🚀 All sponsors can now build a blog using Material for MkDocs!
Check out our new blog to see it in action:https://t.co/hzUmakr7AS
This is how it looks: pic.twitter.com/douB7jck2B
- Ideas take time to develop and writing helps nurture those ideas. Think Digital Gardens
- People can be amazing. You never know who might enjoy the content, learn from it or relate
- I find myself referencing older content beyond just code snippets
- English isn't my first, or second, language. Publishing content can hopefully improve my written communication and develop a skillset that I believe has fallen behind over the years
It finally occurred to me1 that existing efforts have failed because I spent more time playing (debugging) technology, tooling and platforms than thinking, writing and developing ideas.
From wordpress to jekyll to ghost to hugo, tumblr to medium to svbtle to blot.im, heroku to netlify to github pages, cloudflare pages, workers, cache optimization, image storage, CI/CD-flavor of the month, wasm, etc.
I can make the above work, but is this really the goal? Furthermore, the more customized the setup the harder it is to maintain over time.
The more fiddling offered by the technology, the more I'm tempted to do that instead of write. This is why the Blog plugin for Material for MkDocs was such a big deal for me.
Material for MkDocs keeps things simple, while offering just enough customization to make it feel your own.
Now, armed with a setup I'm happy with, I crave simplicity and focus over flexibility and extensibility.
I'll be spending more time writing, developing thoughts, jotting down interesting things and learning how to better express oneself in written form. Stay tuned friends.
I kind-of knew it all along, but didn't want to admit it because it was just too much fun playing with technology! ↩