# Navigation & page building

29 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.

## encryptcontent

A MkDocs plugin that encrypt/decrypt markdown content with AES.

- **Install:** `pip install mkdocs-encryptcontent-plugin`
- **Plugin:** `encryptcontent`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 176 · :lucide-download: 11k/month · :lucide-clock: last commit 2026-05-17 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/unverbuggt/mkdocs-encryptcontent-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-encryptcontent-plugin/)

## literate-nav

MkDocs plugin to specify the navigation in Markdown instead of YAML.

- **Install:** `pip install mkdocs-literate-nav`
- **Plugin:** `literate-nav`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 103 · :lucide-download: 766k/month · :lucide-clock: last commit 2026-04-17 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/oprypin/mkdocs-literate-nav) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-literate-nav/)

## awesome-nav

A plugin for customizing the navigation structure of your MkDocs site.

- **Install:** `pip install mkdocs-awesome-nav`
- **Plugin:** `awesome-nav`
- :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml)
- :lucide-star: 627 · :lucide-download: 562k/month · :lucide-clock: last commit 2026-04-10 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/lukasgeiter/mkdocs-awesome-nav) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-awesome-nav/)

## mkdocs-simple-hooks

Define your own hooks for mkdocs, without having to create a new package.

- **Install:** `pip install mkdocs-simple-hooks`
- **Plugin:** `mkdocs-simple-hooks`
- :lucide-star: 68 · :lucide-download: 50k/month · :lucide-clock: last commit 2023-11-14 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/aklajnert/mkdocs-simple-hooks) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-simple-hooks/)

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

## exclude

A mkdocs plugin that lets you exclude files or trees from your output.

- **Install:** `pip install mkdocs-exclude`
- **Plugin:** `exclude`
- :lucide-star: 96 · :lucide-download: 253k/month · :lucide-clock: last commit 2019-02-20 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/apenwarr/mkdocs-exclude) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-exclude/)

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

## Publisher for MkDocs - meta

Automatic navigation based on files metadata with URL name and publication status control.

- **Install:** `pip install mkdocs-publisher`
- **Plugin:** `pub-meta`
- :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/)

## section-index

MkDocs plugin to allow clickable sections that lead to an index page.

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

## mkdocs-gallery

Same features as sphinx-gallery (https://sphinx-gallery.github.io/) but on mkdocs (https://www.mkdocs.org/) (no sphinx..

- **Install:** `pip install mkdocs-gallery`
- **Plugin:** `gallery`
- :lucide-star: 51 · :lucide-download: 3.6k/month · :lucide-clock: last commit 2024-09-30 · :lucide-scale: BSD-3-Clause
- [:brand-github: GitHub](https://github.com/smarie/mkdocs-gallery) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-gallery/)

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

## mkdocs-nav-weight

A simple mkdocs plugin, enables to organize Navigation in a more markdownic way.

- **Install:** `pip install mkdocs-nav-weight`
- **Plugin:** `mkdocs-nav-weight`
- :lucide-star: 14 · :lucide-download: 36k/month · :lucide-clock: last commit 2025-09-09 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/shu307/mkdocs-nav-weight) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-nav-weight/)

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

## mkdocs-pagetree-plugin

MkDocs plugin that allows you to display the page tree. Like `sitemap.xml`, but for humans.

- **Install:** `pip install mkdocs-pagetree-plugin`
- **Plugin:** `pagetree`
- :lucide-star: 12 · :lucide-download: 3.2k/month · :lucide-clock: last commit 2025-11-02 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/tombreit/mkdocs-pagetree-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-pagetree-plugin/)

## mkdocs-live-edit-plugin

An MkDocs plugin that allows editing pages directly from the browser.

- **Install:** `pip install mkdocs-live-edit-plugin`
- **Plugin:** `live-edit`
- :lucide-star: 37 · :lucide-download: 533/month · :lucide-clock: last commit 2026-04-09 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/EddyLuten/mkdocs-live-edit-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-live-edit-plugin/)

## file-filter

A MkDocs plugin that lets you exclude/include docs files using globs, regexes, gitignore-style file and..

- **Install:** `pip install mkdocs-file-filter-plugin`
- **Plugin:** `file-filter`
- :lucide-star: 10 · :lucide-download: 3.5k/month · :lucide-clock: last commit 2024-07-19 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/DariuszPorowski/mkdocs-file-filter-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-file-filter-plugin/)

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

## mkdocs-categories-plugin

An MkDocs plugin allowing for categorization of wiki pages.

- **Install:** `pip install mkdocs-categories-plugin`
- **Plugin:** `categories`
- :lucide-star: 16 · :lucide-download: 1.1k/month · :lucide-clock: last commit 2026-04-09 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/EddyLuten/mkdocs-categories-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-categories-plugin/)

## MkRefs

MkDocs plugin to generate semantic reference Markdown pages from a knowledge graph.

- **Install:** `pip install mkrefs`
- **Plugin:** `mkrefs`
- :lucide-star: 41 · :lucide-download: 71/month · :lucide-clock: last commit 2023-08-31 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/DerwenAI/mkrefs) · [:brand-pypi: PyPI](https://pypi.org/project/mkrefs/)

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

## mkdocs-breadcrumbs-plugin

Location-based breadcrumbs navigation.

- **Install:** `pip install mkdocs-breadcrumbs-plugin`
- **Plugin:** `mkdocs-breadcrumbs-plugin`
- :lucide-star: 7 · :lucide-download: 1.6k/month · :lucide-clock: last commit 2025-04-18 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/mihaigalos/mkdocs-breadcrumbs-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-breadcrumbs-plugin/)

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

## include directory to navigation

Simple MKDocs plugin than permit to fetch and replace directory in navigation.

- **Install:** `pip install mkdocs-include-dir-to-nav`
- **Plugin:** `include_dir_to_nav`
- :lucide-star: 31 · :lucide-download: 33k/month · :lucide-clock: last commit 2022-03-01
- [:brand-github: GitHub](https://github.com/mysiki/mkdocs_include_dir_to_nav) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-include-dir-to-nav/)

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

## toc-sidebar

An MkDocs plugin that allows users to add additional content to the ToC sidebar using the Material theme.

- **Install:** `pip install mkdocs-toc-sidebar-plugin`
- **Plugin:** `toc-sidebar`
- :lucide-star: 4 · :lucide-download: 782/month · :lucide-clock: last commit 2020-01-11 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/zachhannum/mkdocs-toc-sidebar-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-toc-sidebar-plugin/)

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

## mkdocs-nav-enhancements

WIP plugin for working with titles of pages in MkDocs.

- **Install:** `pip install mkdocs-nav-enhancements`
- **Plugin:** `mkdocs-nav-enhancements`
- :lucide-star: 3 · :lucide-download: 4.7k/month · :lucide-clock: last commit 2019-07-24 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/Rylon/mkdocs-nav-enhancements) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-nav-enhancements/)

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

## vim-md-tags

An MkDocs plugin that creates a vim tag file of all markdown files.

- **Install:** `pip install mkdocs-vim-md-tags-plugin`
- **Plugin:** `vim-md-tags`
- :lucide-star: 6 · :lucide-download: 56/month · :lucide-clock: last commit 2020-05-08 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/zachhannum/mkdocs-vim-md-tags-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-vim-md-tags-plugin/)

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

## authors

MkDocs plugin to display authors dynamically on a template using an .authors.yml file.

- **Install:** `pip install mkdocs-authors-plugin`
- **Plugin:** `authors`
- :lucide-star: 2 · :lucide-download: 50/month · :lucide-clock: last commit 2025-08-05 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/thomaszwagerman/mkdocs-authors-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-authors-plugin/)

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

## schema-reader

A mkdocs plugin that scans specified directories and files for JSON Schema files, converts them to markdown and builds..

- **Install:** `pip install mkdocs-schema-reader`
- **Plugin:** `schema_reader`
- :lucide-star: 7 · :lucide-download: 1.4k/month · :lucide-clock: last commit 2021-06-23 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/magicaljellybeans/mkdocs_schema_reader) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-schema-reader/)

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

## awesome-list

MkDocs Plugin to inject social media cards for each entry in an awesome-list.

- **Plugin:** `awesome-list`
- :lucide-star: 5 · :lucide-clock: last commit 2026-10-03 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/carlosperate/mkdocs-awesome-list-plugin)

## mkdocs-title-casing-plugin

A lightweight mkdocs plugin to add title casing to all mkdocs pages and sections.

- **Install:** `pip install mkdocs-title-casing-plugin`
- **Plugin:** `title-casing`
- :lucide-star: 2 · :lucide-download: 283/month · :lucide-clock: last commit 2023-09-02 · :lucide-scale: GPL-3.0
- [:brand-github: GitHub](https://github.com/mattchristopher314/mkdocs-title-casing-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-title-casing-plugin/)

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

## SWAN Gallery

MkDocs plugin to generate a SWAN Gallery.

- **Install:** `pip install mkdocs-swangallery`
- **Plugin:** `swangallery`
- :lucide-star: 1 · :lucide-download: 39/month · :lucide-clock: last commit 2026-01-23 · :lucide-scale: AGPL-3.0
- [:brand-github: GitHub](https://github.com/swan-cern/mkdocs-swangallery) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-swangallery/)

## mkdocs-navsorted-plugin

mkdocs plugin to get nav sorted without yml directives.

- **Install:** `pip install mkdocs-navsorted-plugin`
- **Plugin:** `navsorted`
- :lucide-download: 192/month · :lucide-clock: last commit 2025-05-24 · :lucide-scale: BSD-3-Clause
- [:brand-github: GitHub](https://github.com/idlesign/mkdocs-navsorted-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-navsorted-plugin/)

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

## select-files

Filter pages for assignments.

- **Install:** `pip install mkdocs-select-files`
- **Plugin:** `select-files`
- :lucide-download: 47/month · :lucide-clock: last commit 2019-09-05 · :lucide-scale: Apache-2.0
- [:brand-github: GitHub](https://github.com/supcik/mkdocs-select-files) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-select-files/)

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

## MkDocs Remove Sections Plugin

Remove sections with specific titles from your MkDocs pages.

- **Install:** `pip install mkdocs-remove-sections-plugin`
- **Plugin:** `remove_sections`
- :lucide-star: 1 · :lucide-download: 30/month · :lucide-clock: last commit 2026-05-31 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/six-two/mkdocs-remove-sections-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-remove-sections-plugin/)

## pagenav-generator

Little something to automatically generate a Navigation within a page itself. Depends on Awesome-pages.

- **Plugin:** `pagenav-generator`
- :lucide-star: 4 · :lucide-clock: last commit 2022-04-17 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/Andre601/mkdocs-pagenav-generator)

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

## mkdocs-pug

- **Install:** `pip install mkdocs-pug`
- :lucide-download: 8/month
- [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-pug/)
