# MkDocs

Python static site generator for project documentation, built from Markdown files and a single YAML configuration file.


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

## Record

### Links

- home: https://www.mkdocs.org/
- repository: https://github.com/mkdocs/mkdocs
- docs: https://www.mkdocs.org/user-guide/
- plugins: https://github.com/mkdocs/catalog

### Identity

- status: active
- maintainer: MkDocs Team
- maintainerType: community
- parent: unknown
- firstRelease: 2014
- hqCountry: unknown

### Kind

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

### Content

- contentStore: flat-file
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: jinja
- i18n: theme localization

### Rendering and deploy

- runsAs: static
- renderingModes: static
- installMethod: pip install mkdocs

### License

- licenseModel: open-source
- license: BSD-2-Clause

### Releases

- currentMajor: 1
- latestReleaseDate: 2024-08-30

### Adoption

- githubStargazers: 22502
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 262
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: 13132209
- httpArchiveSites: 726
- wordpressActiveInstalls: unknown
- dependentRepos: 18004
- dependentPackages: 1494

### Sources

- urls: https://github.com/mkdocs/mkdocs (read 2026-10-18)
- urls: https://pypi.org/pypi/mkdocs/json (read 2026-10-18)
- urls: https://www.mkdocs.org/ (read 2026-10-18)
- firstRelease: https://pypi.org/pypi/mkdocs/json (read 2026-10-18)
- maintainer: https://www.mkdocs.org/ (read 2026-10-20)
- wikidata: https://www.wikidata.org/wiki/Q102565362 (read 2026-10-18)
- category: https://www.mkdocs.org/ (read 2026-10-18)
- language: https://github.com/mkdocs/mkdocs (read 2026-10-18)
- runtime: https://www.mkdocs.org/user-guide/installation/ (read 2026-10-18)
- runtimeMin: https://pypi.org/pypi/mkdocs/json (read 2026-10-18)
- contentStore: https://www.mkdocs.org/ (read 2026-10-18)
- templating: https://www.mkdocs.org/dev-guide/themes/ (read 2026-10-18)
- i18n: https://www.mkdocs.org/user-guide/localizing-your-theme/ (read 2026-10-18)
- renderingModes: https://www.mkdocs.org/ (read 2026-10-18)
- installMethod: https://www.mkdocs.org/user-guide/installation/ (read 2026-10-18)
- license: https://github.com/mkdocs/mkdocs (read 2026-10-18)
- licenseModel: https://github.com/mkdocs/mkdocs (read 2026-10-18)
- currentMajor: https://pypi.org/pypi/mkdocs/json (read 2026-10-18)
- latestReleaseDate: https://github.com/mkdocs/mkdocs/releases/latest (read 2026-10-18)
- githubStargazers: https://github.com/mkdocs/mkdocs (read 2026-10-18)
- contributors: https://api.github.com/repos/mkdocs/mkdocs/contributors?anon=true (read 2026-10-18)
- urls: https://www.mkdocs.org/ (read 2026-10-18)
- runsAs: https://www.mkdocs.org/getting-started/ (read 2026-10-19)
- httpArchiveSites: https://cdn.httparchive.org/v1/technologies (read 2026-10-25)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/mkdocs (read 2026-10-25)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/mkdocs (read 2026-10-25)
- ecosystemsMonthlyDownloads: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/mkdocs (read 2026-10-25)

## Notes

MkDocs reads a folder of Markdown files and one YAML configuration file, then writes a completely static HTML site. Themes use Jinja templates, and two built-in themes ship with MkDocs. The MkDocs Team maintains it, and Tom Christie is named as its founder. Plugins and themes are catalogued in a GitHub repository. The [deployment guide](https://www.mkdocs.org/user-guide/deploying-your-docs/) covers GitHub Pages, Read the Docs and any static file host.

## Worth knowing

A discussion on the project's GitHub page announces a new major version developed in a private repository, and a second discussion asks who should maintain MkDocs. mkdocs.org shows no notice about either. PyPI also carries pre-releases of a new major version under the same name, and it is unclear whether they are the documentation tool.

---

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