catalog

<strong>:trophy: :books: A list of awesome <a href="https://github.com/mkdocs/mkdocs">MkDocs</a> projects and plugins.</strong>







<a href="https://best-of.org" title="Best-of Badge"><img src="http://bit.ly/3o3EHNN"></a>
<a href="#Contents" title="Project Count"><img src="https://img.shields.io/badge/projects-300-blue.svg?color=5ac4bf"></a>
<a href="#Contribution" title="Contributions are welcome"><img src="https://img.shields.io/badge/contributions-welcome-green.svg"></a>
<a href="https://github.com/mkdocs/catalog/releases" title="Catalog Updates"><img src="https://img.shields.io/github/release-date/mkdocs/catalog?color=green&label=updated"></a>

This list contains 300 awesome open-source projects grouped into 17 categories. All projects are ranked by a project-quality score, which is calculated based on various metrics automatically collected from GitHub and different package managers. If you want to add or update projects, feel free to open an issue, submit a pull request, or directly edit the projects.yaml. Contributions are very welcome!

🧙‍♂️ Discover other best-of lists or create your own.

Contents

• 🎨 Theming 31 projects
• 💻 API documentation building 26 projects
• 💬 Blogging 7 projects
• 📊 Charts, Images, Tables & Graphs 40 projects
• 🤖 Code execution, variables & templating 22 projects
• 🌲 Git repos & info 12 projects
• 🌈 HTML processing & CSS styling 16 projects
• 📎 Integrations with other tools 13 projects
• 🌍 Internationalization & localization 3 projects
• 🔗 Links & references 24 projects
• 🧩 Markdown extensions 28 projects
• 🧭 Navigation & page building 28 projects
• ✅ Quality checks (code blocks, spelling, etc.) 6 projects
• 🔍 Search & tables of content 5 projects
• 🍱 Site conversion (PDF/ePUB/etc.) 11 projects
• 🔧 Site building, site management 22 projects
• 📁 Snippets & includes (reusing contents) 9 projects

Explanation

• 🥇🥈🥉  Combined project-quality score
• ⭐️  Star count from GitHub
• 🐣  New project (less than 6 months old)
• 💤  Inactive project (12 months no activity)
• 💀  Dead project (99999 months no activity)
• 📈📉  Project is trending up or down
• ➕  Project was recently added
• ❗️  Warning (e.g. missing/risky license)
• 👨‍💻  Contributors count from GitHub
• 🔀  Fork count from GitHub
• 📋  Issue count from GitHub
• ⏱️  Last update timestamp on package manager
• 📥  Download count from package manager
• 📦  Number of dependent projects
•   MkDocs plugin
•   MkDocs theme
•   Mkdocs-based project (website, templates, etc.)
•   Markdown extension(s)

🎨 Theming

Material for MkDocs - 🥇42 · ⭐ 27K · MIT · ·

Documentation that simply works.

• GitHub (👨‍💻 330 · 🔀 4K · 📦 89K · 📋 2.7K - 0% open · ⏱️ 20.06.2026)
• PyPi (📥 17M / month): pip install mkdocs-material
• Add to mkdocs.yml: yaml theme: material Extras: ```yaml plugins:
  • blog
  • group
  • offline
  • search
  • social
  • tags ```

Shadcn - 🥇24 · ⭐ 180 · 📈 · MIT · ·

Documentation that also shines.

• GitHub (👨‍💻 5 · 🔀 22 · 📥 330 · 📦 88 · 📋 48 - 8% open · ⏱️ 19.06.2026)
• PyPi (📥 29K / month): pip install mkdocs-shadcn
• Add to mkdocs.yml: yaml theme: shadcn Extras: ```yaml plugins:
  • search
  • excalidraw ```

Cinder - 🥇22 · ⭐ 220 · 💤 · MIT ·

A clean, responsive MkDocs theme.

• GitHub (👨‍💻 23 · 🔀 98 · 📥 1K · 📦 710 · 📋 51 - 31% open · ⏱️ 05.01.2021)
• PyPi (📥 7.3K / month): pip install mkdocs-cinder
• Add to mkdocs.yml: yaml theme: cinder

Terminal for MkDocs - 🥇20 · ⭐ 320 · MIT ·

monospace theme for MkDocs.

• GitHub (👨‍💻 4 · 🔀 21 · 📦 160 · 📋 68 - 41% open · ⏱️ 26.03.2026)
• PyPi (📥 7.4K / month): pip install mkdocs-terminal
• Add to mkdocs.yml: yaml theme: terminal Extras: ```yaml plugins:
  • md-to-html ```

Bootswatch - 🥈19 · ⭐ 150 · 💤 · BSD-2 ·

MkDocs Bootswatch Themes.

• GitHub (👨‍💻 10 · 🔀 58 · 📦 1.3K · 📋 33 - 9% open · ⏱️ 29.12.2023)
• PyPi (📥 21K / month): pip install mkdocs-bootswatch
• Add to mkdocs.yml: yaml theme: cerulean theme: cosmo theme: cyborg theme: darkly theme: flatly theme: journal theme: litera theme: lumen theme: lux theme: materia theme: minty theme: pulse theme: sandstone theme: simplex theme: slate theme: solar theme: spacelab theme: superhero theme: united theme: yeti

Simple Blog - 🥈17 · ⭐ 130 · MIT ·

Blog Template for Mkdocs.

• GitHub (👨‍💻 5 · 🔀 13 · 📦 97 · 📋 38 - 7% open · ⏱️ 18.03.2026)
• PyPi (📥 780 / month): pip install mkdocs-simple-blog
• Add to mkdocs.yml: yaml theme: simple-blog

Bootstrap - 🥈17 · ⭐ 95 · 💤 · BSD-2 ·

MkDocs Bootstrap Theme.

• GitHub (👨‍💻 6 · 🔀 34 · 📦 520 · 📋 16 - 6% open · ⏱️ 29.12.2023)
• PyPi (📥 16K / month): pip install mkdocs-bootstrap
• Add to mkdocs.yml: yaml theme: bootstrap

Zettelkasten - 🥈17 · ⭐ 27 · MIT ·

This is a Zettelkasten theme and plugin for MkDocs. It renders the MkDocs pages as cards (zettels).

• GitHub (👨‍💻 5 · 🔀 3 · 📥 58 · 📦 6 · ⏱️ 24.06.2026)
• PyPi (📥 220 / month): pip install mkdocs-zettelkasten
• Add to mkdocs.yml: yaml theme: zettelkasten-solarized-light Extras: ```yaml plugins:
  • zettelkasten ```

Windmill - 🥈16 · ⭐ 130 · 💤 · MIT ·

Outstanding mkdocs theme with a focus on navigation and usability.

• GitHub (👨‍💻 8 · 🔀 52 · 📦 370 · 📋 31 - 48% open · ⏱️ 11.03.2022)
• PyPi (📥 5.3K / month): pip install mkdocs-windmill
• Add to mkdocs.yml: yaml theme: windmill

Dracula - 🥈14 · ⭐ 120 · MIT ·

Dark theme for Mkdocs.

• GitHub (👨‍💻 5 · 🔀 14 · 📦 160 · 📋 17 - 11% o