# Snippets & includes (reusing contents)

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

Data from 2026-11-01.

## include-markdown

Mkdocs Markdown includer plugin.

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

## Markdown-Include

Provides syntax for Python-Markdown which allows for the inclusion of the contents of other Markdown documents.

- **Install:** `pip install markdown-include`
- **Markdown extension:** `markdown_include.include`
- :lucide-star: 116 · :lucide-download: 240k/month · :lucide-clock: last commit 2023-02-07 · :lucide-scale: GPL-3.0
- [:brand-github: GitHub](https://github.com/cmacmackin/markdown-include) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-include/)

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

## meta-descriptions

Generate meta descriptions from the first paragraphs in your MkDocs pages.

- **Install:** `pip install mkdocs-meta-descriptions-plugin`
- **Plugin:** `meta-descriptions`
- :lucide-star: 20 · :lucide-download: 12k/month · :lucide-clock: last commit 2026-10-10 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/prcr/mkdocs-meta-descriptions-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-meta-descriptions-plugin/)

## codeinclude

A plugin to include code snippets into mkdocs pages.

- **Install:** `pip install mkdocs-codeinclude-plugin`
- **Plugin:** `codeinclude`
- :lucide-star: 18 · :lucide-download: 33k/month · :lucide-clock: last commit 2026-02-20 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/rnorth/mkdocs-codeinclude-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-codeinclude-plugin/)

## mkdocs-embed-external-markdown

MkDocs Embed External Markdown plugin that allow to inject section or all full markdown content from a given url. The..

- **Install:** `pip install mkdocs-embed-external-markdown`
- **Plugin:** `external-markdown`
- :lucide-star: 11 · :lucide-download: 7.4k/month · :lucide-clock: last commit 2025-02-24 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/fire1ce/mkdocs-embed-external-markdown) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-embed-external-markdown/)

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

## markdown-version-annotations

MkDocs plugin to add custom admonitions for documenting version differences.

- **Install:** `pip install markdown-version-annotations`
- **Markdown extension:** `markdown_version_annotations`
- :lucide-star: 9 · :lucide-download: 16k/month · :lucide-clock: last commit 2024-05-06 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/glennmatthews/markdown-version-annotations) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-version-annotations/)

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

## Mdx Include

Python Markdown extension to include local or remote files.

- **Install:** `pip install mdx-include`
- **Markdown extension:** `mdx_include`
- :lucide-star: 63 · :lucide-download: 75k/month · :lucide-clock: last commit 2022-07-26
- [:brand-github: GitHub](https://github.com/neurobin/mdx_include) · [:brand-pypi: PyPI](https://pypi.org/project/mdx-include/)

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

## git snippet

Mkdocs plugin that allow to inject snippet or all markdown content from a given remote git repository.

- **Install:** `pip install mkdocs-gitsnippet-plugin`
- **Plugin:** `gitsnippet`
- :lucide-star: 8 · :lucide-download: 441/month · :lucide-clock: last commit 2020-11-15 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/samcomi/mkdocs-gitsnippet-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-gitsnippet-plugin/)

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

## snippet

An mkdocs plugin that injects snippets from a file in a git repository.

- **Install:** `pip install mkdocs-snippet-plugin`
- **Plugin:** `snippet`
- :lucide-star: 11 · :lucide-download: 436/month · :lucide-clock: last commit 2021-10-21 · :lucide-scale: MIT
- [:brand-github: GitHub](https://github.com/mprivat/mkdocs-snippet-plugin) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-snippet-plugin/)

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