Brussels / 3 & 4 February 2024


Easily Going Beyond MarkDown with Material for MkDocs

I first used Material for MkDocs in April 2020, and it quickly became clear to me that this would become my tool of choice for all technical documentation I'm involved in.

Since then, I have been involved in using Material for MkDocs for both creating new and revamping existing documentation sites, in collaboration with others:

In this talk I want to try and convince you that you should be using Material for MkDocs too. I will present a high-level overview of the project, highlight the features that got me hooked, and share my personal experience with using it to produce technical documentation.

To demonstrate how easy it is to get started with Material for MkDocs from scratch, I will build a small documentation website step-by-step live during the talk to showcase some of its features. Material for MkDocs makes writing documentation easy and rewarding, and significantly lowers the bar to produce good looking yet practical technical documentation for free and open source software projects.

It features a broad set of features, including (but not limited to):

Material for MkDocs is open source first (MIT-licensed), and follows the sponsorware release strategy (see Insiders). This means that new features are first exclusively released to sponsors and later become part of the free community edition when specific funding goals are met, which helps making the project sustainable.

It is used by plethora of FOSS projects & beyond, like:


Photo of Kenneth Hoste Kenneth Hoste
Martin Donath