Catalog
:trophy: :books: A list of awesome MkDocs projects and plugins.
Install / Use
/learn @mkdocs/CatalogREADME
<!-- markdownlint-disable -->
<h1 align="center">
catalog
<br>
</h1>
<p align="center">
<strong>:trophy: :books: A list of awesome <a href="https://github.com/mkdocs/mkdocs">MkDocs</a> projects and plugins.</strong>
</p>
<p align="center">
<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>
</p>
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
- <img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"> MkDocs plugin
- <img src="https://cdn.icon-icons.com/icons2/1495/PNG/32/preferencesdesktoptheme_102980.png" style="display:inline;" width="13" height="13"> MkDocs theme
- <img src="https://cdn.icon-icons.com/icons2/1448/PNG/32/42498factory_99134.png" style="display:inline;" width="13" height="13"> Mkdocs-based project (website, templates, etc.)
- <img src="https://cdn.icon-icons.com/icons2/1459/PNG/32/2799201-jigsaw-processing_99781.png" style="display:inline;" width="13" height="13"> Markdown extension(s)
🎨 Theming
<a href="#contents"><img align="right" width="15" height="15" src="https://git.io/JtehR" alt="Back to top"></a>
<details><summary><b><a href="https://github.com/squidfunk/mkdocs-material">Material for MkDocs</a></b> - 🥇42 · ⭐ 25K · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1495/PNG/32/preferencesdesktoptheme_102980.png" style="display:inline;" width="13" height="13"></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>Documentation that simply works.</summary> <a href="https://pawamoy.github.io/mkdocs-gallery/themes/material/"> <img src="https://pawamoy.github.io/mkdocs-gallery/assets/img/material.png" width="400" align="right"> </a>- GitHub (👨💻 330 · 🔀 3.8K · 📦 75K · 📋 2.6K - 0% open · ⏱️ 06.11.2025)
- PyPi (📥 12M / month):
pip install mkdocs-material - Add to mkdocs.yml:
Extras:theme: materialplugins: - blog - group - offline - search - social - tags
- GitHub (👨💻 23 · 🔀 98 · 📥 1K · 📦 690 · 📋 51 - 31% open · ⏱️ 05.01.2021)
- PyPi (📥 6.9K / month):
pip install mkdocs-cinder - Add to mkdocs.yml:
theme: cinder
- GitHub (👨💻 10 · 🔀 57 · 📦 1.2K · 📋 33 - 9% open · ⏱️ 29.12.2023)
- PyPi (📥 18K / month):
pip install mkdocs-bootswatch - Add to mkdocs.yml:
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
- GitHub (🔀 6 · 📥 110 · 📦 19 · 📋 19 - 10% open · ⏱️ 20.10.2025)
- PyPi (📥 2.6K / month):
pip install mkdocs-shadcn - Add to mkdocs.yml:
Extras:theme: shadcnplugins: - search - excalidraw
- GitHub (👨💻 3 · 🔀 19 · 📦 140 · 📋 68 - 42% open · ⏱️ 18.08.2025)
- PyPi (📥 2.9K / month):
pip install mkdocs-terminal - Add to mkdocs.yml:
Extras:theme: terminalplugins: - md-to-html
<a href="htt
