# MkDocs Catalog

**Find the right *MkDocs plugin*.**

> 306 plugins, themes and Markdown extensions for MkDocs NG and MkDocs, ranked by usage and activity. Marked when they build on MkDocs NG.

```sh
pip install mkdocs-ng
```

- [Browse categories](#categories)
- [Tested on MkDocs NG](ng-tested.md)
- [GitHub](https://github.com/mkdocs-ng/catalog)

- **306** projects
- **17** categories
- **31** tested on MkDocs NG every week

## Categories

- :lucide-palette: [Theming](categories/theming.md)
  33 projects
- :lucide-code: [API documentation building](categories/api-docs.md)
  26 projects
- :lucide-pen-line: [Blogging](categories/blogging.md)
  7 projects
- :lucide-chart-column: [Charts, Images, Tables & Graphs](categories/charts.md)
  40 projects
- :lucide-terminal: [Code execution, variables & templating](categories/code-exec-templating.md)
  22 projects
- :lucide-git-branch: [Git repos & info](categories/git-info.md)
  12 projects
- :lucide-paintbrush: [HTML processing & CSS styling](categories/html-css.md)
  16 projects
- :lucide-plug: [Integrations with other tools](categories/integrations.md)
  13 projects
- :lucide-languages: [Internationalization & localization](categories/i18n-l10n.md)
  3 projects
- :lucide-link: [Links & references](categories/links-refs.md)
  24 projects
- :lucide-puzzle: [Markdown extensions](categories/markdown.md)
  28 projects
- :lucide-compass: [Navigation & page building](categories/nav-pages.md)
  29 projects
- :lucide-circle-check: [Quality checks (code blocks, spelling, etc.)](categories/quality.md)
  6 projects
- :lucide-search: [Search & tables of content](categories/search-toc.md)
  5 projects
- :lucide-file-output: [Site conversion (PDF/ePUB/etc.)](categories/site-conversion.md)
  11 projects
- :lucide-wrench: [Site building, site management](categories/site-management.md)
  22 projects
- :lucide-files: [Snippets & includes (reusing contents)](categories/snippets-include.md)
  9 projects
{.cards}

## Most downloaded

| Project | Category | Downloads/month | Tested on NG |
| --- | --- | --- | --- |
| [PyMdown Extensions](categories/markdown.md#pymdown-extensions) | Markdown extensions | 18.3M | ✓ |
| [Material for MkDocs](categories/theming.md#material-for-mkdocs) | Theming | 11.7M | ✓ |
| [mkdocstrings](categories/api-docs.md#mkdocstrings) | API documentation building | 5.8M | ✓ |
| [autorefs](categories/links-refs.md#autorefs) | Links & references | 5.8M | ✓ |
| [mkdocstrings-python](categories/api-docs.md#mkdocstrings-python) | API documentation building | 5.8M |  |
| [macros](categories/code-exec-templating.md#macros) | Code execution, variables & templating | 1.3M | ✓ |
| [monorepo](categories/site-management.md#monorepo) | Site building, site management | 1.3M | ✓ |
| [mkdocs-redirects](categories/links-refs.md#mkdocs-redirects) | Links & references | 1.2M | ✓ |
| [git-revision-date-localized](categories/git-info.md#git-revision-date-localized) | Git repos & info | 1.2M | ✓ |
| [gen-files](categories/code-exec-templating.md#gen-files) | Code execution, variables & templating | 997k | ✓ |
| [MkDocs GLightbox](categories/charts.md#mkdocs-glightbox) | Charts, Images, Tables & Graphs | 986k | ✓ |
| [markdown-exec](categories/code-exec-templating.md#markdown-exec) | Code execution, variables & templating | 979k | ✓ |
| [Mdx Truly Sane Lists](categories/markdown.md#mdx-truly-sane-lists) | Markdown extensions | 970k |  |
| [mike](categories/site-management.md#mike) | Site building, site management | 908k | ✓ |
| [section-index](categories/nav-pages.md#section-index) | Navigation & page building | 807k |  |
{.striped}

## How projects are ranked

Projects are sorted by a quality score computed from GitHub and PyPI data: stars, downloads, dependents, contributors and recent activity. The data is refreshed every Thursday.

## Add or update a project

Edit [projects.yaml](https://github.com/mkdocs-ng/catalog/edit/main/projects.yaml) and open a pull request, or [suggest a project](https://github.com/mkdocs-ng/catalog/issues/new/choose) in an issue.

## Start with MkDocs NG

MkDocs NG is a maintained, drop-in replacement for MkDocs 1.x. Your `mkdocs.yml` and plugins keep working:

```sh
pip install mkdocs-ng
```

Read the [migration guide](https://mkdocs-ng.org/user-guide/migrating/) or try [Sumi](https://sumi.mkdocs-ng.org/), the MkDocs NG theme.