Skip to content

Why MkDocs?

MkDocs#

I use MkDocs + MkDocs Material to document, which is what generated this site. Link

I find the following features to be great:

  • Free and Open Source Software
  • Statically Generated
  • Fairly Sane Theme Defaults
  • Fast Content Search Engine
  • Autolinking (Keeps links to pages alive even after moving)
  • Powerful Syntax Highlighting
  • Linkable Content Tabs (Multiple Programming Language / OS Options)
  • Admonition
  • RSS
  • Auto-Date Tracking
  • Multilingual Support
  • Multi-Version Support
  • All paid features are now free. link

I have a few dislikes:

  • mkdocs-material is in final release with an end-of-support in Nov 2026.
  • The mkdocs-material theme struggles with 50% split 1080p views. I have fixed this.