# Theming

33 projects, most used and most active first. 2 of them build on MkDocs NG in the weekly [compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml).

Data from 2026-11-01.

## Material for MkDocs

Documentation that simply works.

- **Install:** `pip install mkdocs-material`
- **Theme:** `material`
- **Plugins:** `material/blog`, `material/group`, `material/offline`, `material/search`, `material/social`, `material/tags`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 28k · :lucide-download: 11.7M/month · :lucide-clock: last commit 2026-10-30 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/squidfunk/mkdocs-material) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-material/)

## Shadcn

Documentation that also shines.

- **Install:** `pip install mkdocs-shadcn`
- **Theme:** `shadcn`
- **Plugins:** `shadcn/search`, `shadcn/excalidraw`
- :lucide-star: 218 · :lucide-download: 36k/month · :lucide-clock: last commit 2026-10-23 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/asiffer/mkdocs-shadcn) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-shadcn/)

## Cinder

A clean, responsive MkDocs theme.

- **Install:** `pip install mkdocs-cinder`
- **Theme:** `cinder`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 225 · :lucide-download: 5.0k/month · :lucide-clock: last commit 2021-01-05 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/chrissimpkins/cinder) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-cinder/)

> [!WARNING]
> No commits since 2021-01-05. Check that it still fits your setup.

## Bootswatch

MkDocs Bootswatch Themes.

- **Install:** `pip install mkdocs-bootswatch`
- **Theme:** `['cerulean', 'cosmo', 'cyborg', 'darkly', 'flatly', 'journal', 'litera', 'lumen', 'lux', 'materia', 'minty', 'pulse', 'sandstone', 'simplex', 'slate', 'solar', 'spacelab', 'superhero', 'united', 'yeti']`
- :lucide-star: 149 · :lucide-download: 18k/month · :lucide-clock: last commit 2023-12-29 · :lucide-scale: BSD-2-Clause
- [:brand-github: GitHub](https://github.com/mkdocs/mkdocs-bootswatch) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-bootswatch/)

> [!WARNING]
> No commits since 2023-12-29. Check that it still fits your setup.

## Simple Blog

Blog Template for Mkdocs.

- **Install:** `pip install mkdocs-simple-blog`
- **Theme:** `simple-blog`
- :lucide-star: 132 · :lucide-download: 678/month · :lucide-clock: last commit 2026-09-18 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/FernandoCelmer/mkdocs-simple-blog) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-simple-blog/)

## Terminal for MkDocs

monospace theme for MkDocs.

- **Install:** `pip install mkdocs-terminal`
- **Theme:** `terminal`
- **Plugin:** `terminal/md-to-html`
- :lucide-star: 324 · :lucide-download: 4.3k/month · :lucide-clock: last commit 2026-03-26 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/ntno/mkdocs-terminal) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-terminal/)

## Dracula

Dark theme for Mkdocs.

- **Install:** `pip install mkdocs-dracula-theme`
- **Theme:** `dracula`
- :lucide-star: 125 · :lucide-download: 6.8k/month · :lucide-clock: last commit 2026-08-16 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/dracula/mkdocs) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-dracula-theme/)

## Bootstrap

MkDocs Bootstrap Theme.

- **Install:** `pip install mkdocs-bootstrap`
- **Theme:** `bootstrap`
- :lucide-star: 95 · :lucide-download: 19k/month · :lucide-clock: last commit 2023-12-29 · :lucide-scale: BSD-2-Clause
- [:brand-github: GitHub](https://github.com/mkdocs/mkdocs-bootstrap) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-bootstrap/)

> [!WARNING]
> No commits since 2023-12-29. Check that it still fits your setup.

## Windmill

Outstanding mkdocs theme with a focus on navigation and usability.

- **Install:** `pip install mkdocs-windmill`
- **Theme:** `windmill`
- :lucide-star: 129 · :lucide-download: 6.6k/month · :lucide-clock: last commit 2022-03-11 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/gristlabs/mkdocs-windmill) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-windmill/)

> [!WARNING]
> No commits since 2022-03-11. Check that it still fits your setup.

## Zettelkasten

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

- **Install:** `pip install mkdocs-zettelkasten`
- **Theme:** `zettelkasten`
- **Plugin:** `zettelkasten`
- :lucide-star: 27 · :lucide-download: 119/month · :lucide-clock: last commit 2026-10-28 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/buvis/mkdocs-zettelkasten) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-zettelkasten/)

## Lantana

Lantana MKDocsHTML.

- **Install:** `pip install lantana`
- **Theme:** `lantana`
- :lucide-star: 26 · :lucide-download: 363/month · :lucide-clock: last commit 2025-07-03 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/wsoft-ws/lantana) · [:brand-pypi: PyPI](https://pypi.org/project/lantana/)

> [!WARNING]
> No commits since 2025-07-03. Check that it still fits your setup.

## SWAN

SWAN MkDocs theme.

- **Install:** `pip install mkdocs-swan`
- **Theme:** `swan`
- :lucide-star: 8 · :lucide-download: 1.7k/month · :lucide-clock: last commit 2026-09-24 · :lucide-scale: AGPL-3.0
- [:brand-github: GitHub](https://github.com/swan-cern/mkdocs-swan) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-swan/)

## Torillic

A D&D inspired theme for styling TTRPG notes and resources.

- **Install:** `pip install mkdocs-torillic`
- **Theme:** `torillic`
- :lucide-star: 136 · :lucide-download: 337/month · :lucide-clock: last commit 2025-04-21 · :lucide-scale: CC0-1.0
- [:brand-github: GitHub](https://github.com/TEParsons/torillic) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-torillic/)

> [!WARNING]
> No commits since 2025-04-21. Check that it still fits your setup.

## KPN for MkDocs

KPN theme for MkDocs, ProperDocs and Zensical | owner=des.

- **Install:** `pip install mkdocs-kpn`
- **Theme:** `kpn`
- :lucide-star: 10 · :lucide-download: 460/month · :lucide-clock: last commit 2026-05-12 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/kpn/mkdocs-kpn-theme) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-kpn/)

## MkDocs NG Material

Material for MkDocs, maintained for MkDocs NG with security and bug fixes.

- **Install:** `pip install mkdocs-ng-material`
- **Theme:** `material`
- **Plugins:** `material/blog`, `material/group`, `material/offline`, `material/search`, `material/social`, `material/tags`
- :lucide-star: 3 · :lucide-download: 206/month · :lucide-clock: last commit 2026-11-01 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/mkdocs-ng/mkdocs-material) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-ng-material/)

## Bootstrap 4

A vanilla Bootstrap 4 theme for MkDocs.

- **Install:** `pip install mkdocs-theme-bootstrap4`
- **Theme:** `bootstrap4`
- **Plugins:** `bootstrap4-blockquotes`, `bootstrap4-tables`
- :lucide-star: 8 · :lucide-download: 206/month · :lucide-clock: last commit 2024-11-23 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/LukeCarrier/mkdocs-theme-bootstrap4) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-theme-bootstrap4/)

> [!WARNING]
> No commits since 2024-11-23. Check that it still fits your setup.

## mkdocs-curriculum-vitae

A simple MkDocs theme, designed to make your curriculum vitae (CV) with minimal configuration, and several themes.

- **Install:** `pip install mkdocs-curriculum-vitae`
- **Theme:** `curriculum-vitae`
- :lucide-star: 7 · :lucide-download: 45/month · :lucide-clock: last commit 2025-11-12 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/Paul-Riviere/mkdocs-curriculum-vitae) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-curriculum-vitae/)

## Landing

An mkdocs theme geared towards making a personal landing page, with simpler navigation and heavily customisable style..

- **Install:** `pip install mkdocs-landing`
- **Theme:** `landing`
- :lucide-star: 29 · :lucide-download: 72/month · :lucide-clock: last commit 2026-10-01 · :lucide-scale: CC0-1.0
- [:brand-github: GitHub](https://github.com/TEParsons/mkdocs-landing) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-landing/)

## CustomMill

Outstanding mkdocs theme with a focus on navigation, customization and usability.

- **Install:** `pip install mkdocs-custommill`
- **Theme:** `custommill`
- :lucide-star: 19 · :lucide-download: 382/month · :lucide-clock: last commit 2022-03-10
- [:brand-github: GitHub](https://github.com/Siphalor/mkdocs-custommill) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-custommill/)

> [!WARNING]
> No commits since 2022-03-10. Check that it still fits your setup.

## Nature

A MkDocs theme.

- **Install:** `pip install mkdocs-nature`
- **Theme:** `nature`
- :lucide-star: 5 · :lucide-download: 1.3k/month · :lucide-clock: last commit 2025-09-04
- [:brand-github: GitHub](https://github.com/waylan/mkdocs-nature) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-nature/)

> [!WARNING]
> No commits since 2025-09-04. Check that it still fits your setup.

## GitBook

Default theme for GitBook for Mkdocs https://lramage.gitlab.io/mkdocs-gitbook-theme.

- **Install:** `pip install mkdocs-gitbook`
- **Theme:** `gitbook`
- :lucide-star: 30 · :lucide-download: 21k/month
- [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-gitbook/) · [Homepage](https://gitlab.com/lramage/mkdocs-gitbook-theme)

## Ivory

Ivory theme for MkDocs.

- **Install:** `pip install mkdocs-ivory`
- **Theme:** `ivory`
- :lucide-star: 10 · :lucide-download: 1.7k/month · :lucide-clock: last commit 2020-06-16 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/daizutabi/mkdocs-ivory) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-ivory/)

> [!WARNING]
> No commits since 2020-06-16. Check that it still fits your setup.

## Windmill Dark

Outstanding mkdocs theme with a focus on navigation and usability.

- **Install:** `pip install mkdocs-windmill-dark`
- **Theme:** `windmill-dark`
- :lucide-star: 38 · :lucide-download: 395/month · :lucide-clock: last commit 2022-05-12
- [:brand-github: GitHub](https://github.com/noraj/mkdocs-windmill-dark) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-windmill-dark/)

> [!WARNING]
> No commits since 2022-05-12. Check that it still fits your setup.

## Alabaster

Alabaster port for MkDocs.

- **Install:** `pip install mkdocs-alabaster`
- **Theme:** `alabaster`
- :lucide-star: 36 · :lucide-download: 541/month · :lucide-clock: last commit 2020-06-16
- [:brand-github: GitHub](https://github.com/notpushkin/mkdocs-alabaster) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-alabaster/)

> [!WARNING]
> No commits since 2020-06-16. Check that it still fits your setup.

## GitHub

Theme Mkdocs Like a Github. DEMO =.

- **Install:** `pip install mkdocs-github`
- **Theme:** `github`
- :lucide-star: 6 · :lucide-download: 135/month · :lucide-clock: last commit 2020-02-25 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/g3xx/mkdocs-Github) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-github/)

> [!WARNING]
> No commits since 2020-02-25. Check that it still fits your setup.

## Risonia

A simple theme for MkDocs, using the w3.css framework and configurable color schemes.

- **Install:** `pip install mkdocs-risonia-theme`
- **Theme:** `risonia`
- **Plugins:** `risonia/color-theme`, `risonia/w3css-classes`
- :lucide-star: 4 · :lucide-download: 45/month · :lucide-clock: last commit 2025-12-31
- [:brand-github: GitHub](https://github.com/unverbuggt/mkdocs-risonia-theme) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-risonia-theme/)

## BOOTSTRAP386

A vintage 1980s DOS inspired Twitter Bootstrap theme for MkDocs https://lramage.gitlab.io/mkdocs-bootstrap386.

- **Install:** `pip install mkdocs-bootstrap386`
- **Theme:** `bootstrap386`
- :lucide-star: 37 · :lucide-download: 218/month
- [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-bootstrap386/) · [Homepage](https://gitlab.com/lramage/mkdocs-bootstrap386)

## mkdocs-theme-topdf

A mkdocs theme for create PDF and printing with paged.js.

- **Install:** `pip install mkdocs-theme-topdf`
- **Theme:** `topdf`
- :lucide-star: 17 · :lucide-download: 34/month · :lucide-clock: last commit 2025-05-22 · :lucide-scale: MPL-2.0
- [:brand-github: GitHub](https://github.com/kuri65536/mkdocs-theme-topdf) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-theme-topdf/)

> [!WARNING]
> No commits since 2025-05-22. Check that it still fits your setup.

## Moonstone

A documentation theme for mkdocs.

- **Install:** `pip install mkdocs-moonstone`
- **Theme:** `moonstone`
- :lucide-star: 8 · :lucide-download: 78/month · :lucide-clock: last commit 2021-06-15
- [:brand-github: GitHub](https://github.com/byrnereese/mkdocs-moonstone) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-moonstone/)

> [!WARNING]
> No commits since 2021-06-15. Check that it still fits your setup.

## docSkimmer

An accessible, skimmable theme for MkDocs.

- **Theme:** `docskimmer`
- :lucide-star: 20 · :lucide-clock: last commit 2025-12-17
- [:brand-github: GitHub](https://github.com/hfagerlund/mkdocs-docskimmer)

## mkdocs-rtl

mkdocs rtl theme based on mkdocs-material.

- :lucide-star: 25 · :lucide-clock: last commit 2017-10-22 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/mberneti/mkdocs-rtl)

> [!WARNING]
> No commits since 2017-10-22. Check that it still fits your setup.

## Sumi

Local-first documentation theme for MkDocs NG with a landing page, blog, releases and print edition.

- **Install:** `pip install mkdocs-sumi`
- **Theme:** `sumi`
- **Plugin:** `sumi`
- :lucide-clock: last commit 2026-11-01 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/mkdocs-ng/mkdocs-sumi) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-sumi/)

## Cluster

Another bootstrap theme for MkDocs.

- **Install:** `pip install mkdocs-cluster`
- **Theme:** `cluster`
- :lucide-star: 6 · :lucide-download: 330/month
- [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-cluster/) · [Homepage](https://gitlab.com/kaliko/mkdocs-cluster)