# Material for MkDocs

Documentation framework on top of MkDocs that builds static documentation sites from Markdown.


Source: https://findsoftware.frbit.cloud/mkdocs-material/
Last reviewed: 2026-10-23
Updated: 2026-10-25
Listed since: 2026-10-23

## Record

### Links

- home: https://squidfunk.github.io/mkdocs-material/
- repository: https://github.com/squidfunk/mkdocs-material
- docs: https://squidfunk.github.io/mkdocs-material/getting-started/
- x: https://x.com/squidfunk
- bluesky: https://bsky.app/profile/squidfunk.com
- mastodon: https://fosstodon.org/@squidfunk
- discord: https://discord.gg/hqXRNq9CjT

### Identity

- status: active
- maintainer: Martin Donath
- maintainerType: individual
- parent: unknown
- firstRelease: 2016
- hqCountry: unknown

### Kind

- category: ssg
- hosting: static
- language: python
- runtime: python
- runtimeMin: python 3.8
- basedOn: mkdocs

### Content

- contentStore: flat-file
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: yes

### Rendering and deploy

- runsAs: static, local
- renderingModes: static
- installMethod: pip, docker, git

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 9
- latestReleaseDate: 2026-07-17

### Adoption

- githubStargazers: 27587
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 311
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: 11666824
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 13193
- dependentPackages: 1343

### Sources

- urls: https://api.github.com/repos/squidfunk/mkdocs-material (read 2026-10-23)
- urls: https://squidfunk.github.io/mkdocs-material/ (read 2026-10-23)
- maintainer: https://github.com/squidfunk/mkdocs-material/blob/master/LICENSE (read 2026-10-23)
- language: https://api.github.com/repos/squidfunk/mkdocs-material (read 2026-10-23)
- license: https://api.github.com/repos/squidfunk/mkdocs-material (read 2026-10-23)
- license: https://squidfunk.github.io/mkdocs-material/ (read 2026-10-23)
- category: https://squidfunk.github.io/mkdocs-material/getting-started/ (read 2026-10-23)
- runtime: https://squidfunk.github.io/mkdocs-material/getting-started/ (read 2026-10-23)
- runtimeMin: https://pypi.org/pypi/mkdocs-material/json (read 2026-10-23)
- installMethod: https://squidfunk.github.io/mkdocs-material/getting-started/ (read 2026-10-23)
- renderingModes: https://squidfunk.github.io/mkdocs-material/creating-your-site/ (read 2026-10-23)
- githubStargazers: https://api.github.com/repos/squidfunk/mkdocs-material (read 2026-10-23)
- contributors: https://api.github.com/repos/squidfunk/mkdocs-material/contributors (read 2026-10-23)
- firstRelease: https://api.github.com/repos/squidfunk/mkdocs-material/releases (read 2026-10-23)
- latestReleaseDate: https://api.github.com/repos/squidfunk/mkdocs-material/releases/latest (read 2026-10-23)
- urls: https://squidfunk.github.io/mkdocs-material/getting-started/ (read 2026-10-23)
- basedOn: https://squidfunk.github.io/mkdocs-material/getting-started/ (read 2026-10-23)
- contentStore: https://squidfunk.github.io/mkdocs-material/creating-your-site/ (read 2026-10-23)
- i18n: https://github.com/squidfunk/mkdocs-material/blob/master/README.md (read 2026-10-23)
- runsAs: https://squidfunk.github.io/mkdocs-material/creating-your-site/ (read 2026-10-23)
- runsAs: https://squidfunk.github.io/mkdocs-material/creating-your-site/ (read 2026-10-23)
- currentMajor: https://api.github.com/repos/squidfunk/mkdocs-material/releases (read 2026-10-23)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/mkdocs-material (read 2026-10-25)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/mkdocs-material (read 2026-10-25)
- ecosystemsMonthlyDownloads: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/mkdocs-material (read 2026-10-25)

## Notes

Material for MkDocs is a documentation framework built on MkDocs, a static site generator for project documentation. It turns a directory of Markdown files and a configuration file into a static documentation site, with search that runs in the visitor's browser, code annotations and generated social cards. The package is installed with pip, and an official Docker image is provided for local previewing only. The publishing guide describes building the site and deploying it to GitHub Pages or GitLab Pages. Martin Donath maintains the project.

## Worth knowing

The project is in maintenance mode. Critical maintenance continues through May 5, 2027, and the project names Zensical as its successor.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0