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):

Material for MkDocs - complex solution, but paid,
mkdocs-blogging-plugin - works, but simple solution for simple blog (limited tags usage, theme files modification needed, limited use of frontmatter, limited number of features),
mkdocs-blog-plugin - no longer maintained and simple,
python-mkblog - no longer maintained and simple,
mkdocs-blog - no longer maintained and simple,
material theme modification - it's not a plugin, but a complete theme modification, it's hard to extend and configure.

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

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

Changelog ¶

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

Note

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

Backlinks:

Home

Publisher for MkDocs is a set of plugins for https://www.mkdocs.org that was created originally as “yet another blogging plugin for MkDocs” (you can read more about this in this blog post ). During a process of development, I realized that it can become something more that will help not only me with blog creation, but also as a part of a wider publishing tool. Documents creation can be used with cooperation with an https://obsidian.md/ that is a tool for creating a second brain and also an excellent Markdown files editor.