Finally, a blogging setup I like¶
Kudos to Martin (@squidfunk on ) for the hard work and dedication to the project. I've been following the project for a while and it's been a pleasure to watch it grow. 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 to extend: add CSS, customize fonts, modify JS, etc.
- Sane navigation with options to tweak
- Fantastic documentation with a project Philosophy that resonates
- Finally, Native blog support
That last one (native blog support) was huge for me, for reasons I'll describe in the Writing section.
Here's the announcement tweet:
📣 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.
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! ↩