mkdocs/mkdocs
Some data may be outdated — see provenance labels.
Project documentation with Markdown. observed · 2026-09-22
Health v2 · maintenance only
41/100
- Activity 40
- Release rhythm 8
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-10-21. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 4665
- days_rel: n/a
- days_push: 365
- n_releases_24m: 0
Adoption not part of the score
22457 stars · 2647 forks observed · 2026-09-22
What it is AI-extracted, prompt v1, taxonomy v1, 2026-10-12, confidence 0.99
MkDocs is a fast, simple static site generator written in Python that builds project documentation from Markdown files. It provides a command‑line interface, built‑in dev server, and extensibility via themes and plugins.
Use cases
- Generate project documentation from Markdown sources
- Preview documentation locally with live reload while writing
- Deploy static documentation sites to GitHub Pages or other static hosts
- Customize documentation appearance using built‑in or third‑party themes
- Extend documentation build process with plugins and Markdown extensions
When to choose
- You need a lightweight, Python‑based tool to create static documentation sites.
- You prefer writing docs in Markdown with a simple YAML configuration file.
- You want built‑in live‑preview server and easy deployment to static hosting services.
When to avoid
- You require a full‑featured content management system with dynamic content.
- You need server‑side rendering or complex interactive web applications.
- You are looking for a non‑Python solution or a GUI‑based documentation editor.
Facets
cli-tool · maturity active
static-site-generator cli markdown documentation web-development python cli cross-platform yaml-configuration theme-support plugin-extensions fast-build
10 sources
- readme: https://github.com/mkdocs/mkdocs · fetched 2026-09-22 · 745673d7a4e4
- homepage: https://www.mkdocs.org · fetched 2026-09-28 · 01224c7e60f8
- site_page: https://www.mkdocs.org/getting-started · fetched 2026-09-28 · e18c5be5d632
- site_page: https://www.mkdocs.org/user-guide/writing-your-docs · fetched 2026-09-28 · db8ba3b47c91
- site_page: https://www.mkdocs.org/user-guide/deploying-your-docs · fetched 2026-09-28 · dfcdb2ac99b5
- site_page: https://www.mkdocs.org/about/release-notes · fetched 2026-09-28 · f25e7df081ea
- site_page: https://www.mkdocs.org/about/contributing · fetched 2026-09-28 · 006de663c325
- site_page: https://www.mkdocs.org/about/license · fetched 2026-09-28 · 1742eb5843c4
- site_page: https://www.mkdocs.org/user-guide/choosing-your-theme · fetched 2026-09-28 · 03ff210d9d5b
- site_page: https://www.mkdocs.org/user-guide/installation · fetched 2026-09-28 · 264168bcb690
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| mkdocs/mkdocs | main | 41 |
For agents
Data as of 2026-10-19T08:05:51.212177+00:00 · Report a problem