How to blog with Material MkDocs.¶

MkDocs is a static site generator. Material MkDocs is a theme for MkDocs. MkDocs has no built-in support for blogging, but it is extensible enough to easily add your own. This repo is the experimental precursor to a MkDocs plugin, if there is demand.

Annotate your posts with a beautiful signature!

Turn any page into a list of blog posts. Checkout the blog!

Standardize the look of each blog post with configurable metadata. Checkout a post blog!

Like the look?

Credit for the inspiration and styling should be attributed to @squidfunk Twitter.
For updates or feature requests, follow @4kelly_ Twitter.

Latest Posts¶

Material MkDocs Lighthouse Performance Score

Is MkDocs as fast as the trendier static site generators available today? I measured the Lighthouse performance (Core Web Vitals) score of this blog built with the static site generator MkDocs (Material theme)

While I was evaluating static site generators, I came across a popular tool called Eleventy. It's a "simpler static site generator" written in javascript that's intentionally not tied to any particular javascript framework or templating language.

At least partially through these attributes it's attracted a minimalist and performance oriented culture, epitomized by the official Eleventy Performance Leaderboard - a global ranking of Lighthouse scores for websites created with Eleventy. My favorite project built with Eleventy that I've found so far is @cramforce's high-performance-blog template.

This got me thinking, how fast is Material MkDocs?

Captivating Content

These are some ways to cook with fire outside.

One can cook on and with an open fire. These are some of the ways to cook with fire outside. Cooking meat using a spit is a great way to evenly cook meat. In order to keep meat from burning, it's best to slowly rotate it. Hot stones can be used to toast bread. Coals are hot and can bring things to a boil quickly. If one is very adventurous, one can make a hole in the ground, fill it with coals and place foil-covered meat, veggies, and potatoes into the coals, and cover all of it with dirt. In a short period of time, the food will be baked. Campfire cooking can be done in many ways.

Another Interesting Post

Please enjoy this post.

Sometimes it's just better not to be seen. That's how Harry had always lived his life. He prided himself as being the fly on the wall and the fae that blended into the crowd. That's why he was so shocked that she noticed him.