Skip to content

v0.1.0 - Initial release

Another blogging plugin for MkDocs? But why?

The simplest answer is: because I couldn't find one good enough (and free).

The flip side of the same coin was that I wanted to migrate my personal blog related to testing (sorry only in Polish, but you can try to use Google translator) from Nikola that works quite well, but sometimes is overly complicated, has almost none search functionality and markdown files are not the default one (but it's possible to use them). Why does the Markdown format is so important? Because I love Obsidian as a tool for gathering knowledge, and this format is a crucial part of that tool.

At the time when this plugin was created, there was no free and good alternatives. The only one that could be good enough was hidden behind a paid wall and was a part of a theme Material for MkDocs . Some of the ideas for this plugin and functionalities came from documentation of the Material for MkDocs theme, Nikola and other plugins.

Existing alternatives (with my comment):

As you can see, there are just 2 still maintained plugins for blogging in MkDocs:

  1. Material for MkDocs - complex but paid,
  2. mkdosc-blogging-plugin - much simpler than Material for MkDocs and a bit hacky due to mostly tricks in the template.


This project is now at an early stage of development. Current functionalities are:

  • ❎ blog post update date based on metadata (post YAML frontmatter)
  • ❎ blog post URL link based on metadata (post YAML frontmatter)
  • ❎ blog post tags and categories based on metadata (post YAML frontmatter)
  • ❎ support for blog post teaser
  • ❎ auto generation of blog posts navigation


❎ - added ✅ - fixed ♻️️ - changed 🚫 - removed