# Site building, site management

22 projects, most used and most active first. 3 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.

## mike

Manage multiple versions of your MkDocs-powered documentation via Git.

- **Install:** `pip install mike`
- **Plugin:** `mike`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 748 · :lucide-download: 908k/month · :lucide-clock: last commit 2026-10-13 · :lucide-scale: BSD-3-Clause
- [:brand-github: GitHub](https://github.com/jimporter/mike) · [:brand-pypi: PyPI](https://pypi.org/project/mike/)

## techdocs-core

The core MkDocs plugin used by Backstages TechDocs as a wrapper around multiple MkDocs plugins and Python Markdown..

- **Install:** `pip install mkdocs-techdocs-core`
- **Plugin:** `techdocs-core`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 116 · :lucide-download: 588k/month · :lucide-clock: last commit 2026-10-15 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/backstage/mkdocs-techdocs-core) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-techdocs-core/)

## monorepo

Build multiple documentation folders in a single Mkdocs. Designed for large codebases.

- **Install:** `pip install mkdocs-monorepo-plugin`
- **Plugin:** `monorepo`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 400 · :lucide-download: 1.3M/month · :lucide-clock: last commit 2025-06-15 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/backstage/mkdocs-monorepo-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-monorepo-plugin/)

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

## mkdocs-multirepo-plugin

Build documentation in multiple repos into one site.

- **Install:** `pip install mkdocs-multirepo-plugin`
- **Plugin:** `multirepo`
- :lucide-star: 196 · :lucide-download: 57k/month · :lucide-clock: last commit 2026-03-19 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/jdoiro3/mkdocs-multirepo-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-multirepo-plugin/)

## simple

Build documentation files inside your code into a MkDocs site.

- **Install:** `pip install mkdocs-simple-plugin`
- **Plugin:** `simple`
- :lucide-star: 51 · :lucide-download: 22k/month · :lucide-clock: last commit 2026-10-31 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/athackst/mkdocs-simple-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-simple-plugin/)

## same-dir

ProperDocs plugin to allow placing mkdocs.yml in the same directory as documentation.

- **Install:** `pip install mkdocs-same-dir`
- **Plugin:** `same-dir`
- :lucide-star: 46 · :lucide-download: 134k/month · :lucide-clock: last commit 2026-04-17 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/oprypin/mkdocs-same-dir) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-same-dir/)

## Publisher for MkDocs - debugger

Advanced console and file logger from build and serve process.

- **Install:** `pip install mkdocs-publisher`
- **Plugin:** `pub-debugger`
- :lucide-star: 130 · :lucide-download: 4.2k/month · :lucide-clock: last commit 2025-11-26 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/mkdocs-publisher/mkdocs-publisher) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-publisher/)

## mkdocs-versioning

A tool that allows for versioning sites built with mkdocs.

- **Install:** `pip install mkdocs-versioning`
- **Plugin:** `mkdocs-versioning`
- :lucide-star: 40 · :lucide-download: 3.0k/month · :lucide-clock: last commit 2021-08-01 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/zayd62/mkdocs-versioning) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-versioning/)

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

## markdown-docs

Action/docker image that transforms your markdown into a static website. No need for particular configuration: it just..

- :lucide-star: 29 · :lucide-download: 783/month · :lucide-clock: last commit 2026-10-05 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/ldeluigi/markdown-docs)

## multirepo

A bit like monorepo, but keeps MkDocs projects separate.

- **Install:** `pip install mkdocs-multirepo`
- :lucide-star: 47 · :lucide-download: 369/month · :lucide-clock: last commit 2024-01-04 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/wilhelmer/mkdocs-multirepo) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-multirepo/)

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

## MkDocs Merge

Merge the source of multiple MkDocs sites into a single one.

- **Install:** `pip install mkdocs-merge`
- :lucide-star: 23 · :lucide-download: 2.8k/month · :lucide-clock: last commit 2025-07-05 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/ovasquez/mkdocs-merge) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-merge/)

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

## mkdocs-exclude-unused-files

Exclude orphaned (unused) static files from your mkdocs build.

- **Install:** `pip install mkdocs-exclude-unused-files`
- **Plugin:** `exclude-unused-files`
- :lucide-star: 5 · :lucide-download: 6.3k/month · :lucide-clock: last commit 2025-06-11 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/JonasDoesThings/mkdocs-exclude-unused-files) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-exclude-unused-files/)

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

## mkdocs-note

A MkDocs plugin to add note boxes to your documentation.

- **Install:** `pip install mkdocs-note`
- **Plugin:** `mkdocs-note`
- :lucide-star: 7 · :lucide-download: 631/month · :lucide-clock: last commit 2026-10-01 · :lucide-scale: GPL-3.0
- [:brand-github: GitHub](https://github.com/virtualguard101/mkdocs-note) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-note/)

## mkdocs-auto-refresh-build-pages

MkDocs plugin that automatically refreshes the build pages when the documentation is updated.

- **Install:** `pip install mkdocs-auto-refresh-build-pages`
- **Plugin:** `auto-refresh-build-pages`
- :lucide-star: 3 · :lucide-download: 1.2k/month · :lucide-clock: last commit 2025-07-06 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/JakubAndrysek/mkdocs-auto-refresh-build-pages) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-auto-refresh-build-pages/)

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

## no-sitemap

Disable Mkdocs sitemap generation.

- **Install:** `pip install mkdocs-no-sitemap-plugin`
- **Plugin:** `no-sitemap`
- :lucide-star: 4 · :lucide-download: 1.6k/month · :lucide-clock: last commit 2025-08-23 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/leonardehrenfried/mkdocs-no-sitemap-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-no-sitemap-plugin/)

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

## mkdocs-yamp

Yet Another Multirepo Plugin for MkDocs.

- **Install:** `pip install mkdocs-yamp`
- **Plugin:** `yamp`
- :lucide-star: 2 · :lucide-download: 110/month · :lucide-clock: last commit 2022-10-10 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/boozallen/mkdocs-yamp-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-yamp/)

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

## mkdocs-required-frontmatter-plugin

This MkDocs plugin enforces required frontmatter for documentation pages.

- **Install:** `pip install mkdocs-required-frontmatter-plugin`
- **Plugin:** `required-frontmatter`
- :lucide-star: 4 · :lucide-download: 258/month · :lucide-clock: last commit 2024-03-22 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/unmc-vcr/mkdocs-required-frontmatter-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-required-frontmatter-plugin/)

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

## progress

A plugin for MkDocs that lets you know exactly what is happening during the build.

- **Plugin:** `progress`
- :lucide-star: 5 · :lucide-clock: last commit 2026-04-22 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/RDIL/mkdocs-plugin-progress)

## mkdocs-exclude-tagged-files

A mkdocs plugin for excluding files based on frontmatter tags.

- **Install:** `pip install mkdocs-exclude-tagged-files`
- **Plugin:** `mkdocs_exclude_tagged_files`
- :lucide-star: 4 · :lucide-download: 108/month · :lucide-clock: last commit 2023-09-10 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/JonasDoesThings/mkdocs-exclude-tagged-files) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-exclude-tagged-files/)

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

## mkdocs-new-features-notifier

This plugin enables you to notify users of new features in your product. It does this by identifying new documentation..

- **Install:** `pip install mkdocs-new-features-notifier`
- **Plugin:** `mkdocs-new-features-notifier`
- :lucide-star: 4 · :lucide-download: 610/month · :lucide-clock: last commit 2020-01-15 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/kevin-411/mkdocs-new-features-notifier) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-new-features-notifier/)

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

## multiple

Allows to merge mkdocs documentations dynamically.

- **Install:** `pip install mkdocs-multiple`
- **Plugin:** `multiple`
- :lucide-star: 2 · :lucide-download: 462/month · :lucide-clock: last commit 2019-11-22 · :lucide-scale: GPL-3.0
- [:brand-github: GitHub](https://github.com/experimaestro/mkdocs-multiple) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-multiple/)

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

## octadocs-adr

A blueprint for Architecture Decision Record in Octadocs - the smart documentation environment.

- **Install:** `pip install octadocs-adr`
- **Plugin:** `octadocs_adr`
- :lucide-star: 1 · :lucide-download: 27/month · :lucide-clock: last commit 2021-08-22
- [:brand-github: GitHub](https://github.com/octadocs/octadocs-adr) · [:brand-pypi: PyPI](https://pypi.org/project/octadocs-adr/)

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