NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1002 most downloaded on PyPI
Documentation that simply works
Latest stable
9.8.1
Last release 15 days ago
07 Nov 2026
Release timing varies
gaps range from 9 days to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
444 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Updated Docker image dependencies to fix vulnerabilities
Warning
Material for MkDocs reaches end of life on May 5, 2027. Critical fixes and security updates continue until that date.
We're continuing our work with Zensical, a maintained successor built by the team behind Material for MkDocs. It carries forward what we've learned from building documentation tools with this community, with Markdown authoring, a familiar design, and full control over your content. Zensical is Open Source and MIT-licensed.
You can evaluate Zensical alongside MkDocs using your existing mkdocs.yml. Check plugin compatibility and compare your pages, navigation, search, and customizations before switching. The classic theme variant preserves the appearance of Material for MkDocs. See the migration guide for the steps and current compatibility details.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This is primarily a security release. It raises dependency minimums to address known vulnerabilities. We recommend upgrading to this release and updat…
Warning
Material for MkDocs reaches end of life on May 5, 2027. Critical fixes and security updates continue until that date.
We're continuing our work with Zensical, a maintained successor built by the team behind Material for MkDocs. It carries forward what we've learned from building documentation tools with this community, with Markdown authoring, a familiar design, and full control over your content. Zensical is Open Source and MIT-licensed.
You can evaluate Zensical alongside MkDocs using your existing mkdocs.yml. Check plugin compatibility and compare your pages, navigation, search, and customizations before switching. The classic theme variant preserves the appearance of Material for MkDocs. See the migration guide for the steps and current compatibility details.
This is primarily a security release. It raises dependency minimums to address known vulnerabilities. We recommend upgrading to this release and updating your dependency lockfiles.
Python 3.11 or newer is now required. Python 3.8–3.10 are no longer supported.
Previous dependency ranges allowed versions with known vulnerabilities. The new minimums cover core Python dependencies and the optional git and imaging extras, including GitPython 3.2.1 or newer for the git extra.
Recent releases of mkdocs-rss-plugin and mkdocs-redirects depend on ProperDocs, a separate static site generator that Material for MkDocs does not require. Removing these plugins from the recommended extra keeps its dependency footprint smaller and leaves the choice of additional tools to each project. If your project uses RSS feeds or redirects, declare the relevant plugin explicitly in your own dependencies.
The CLI notice now gives the May 5, 2027 end-of-life date and links to the Zensical migration guide. It also clarifies that third-party ProperDocs migration notices do not represent a recommendation from the Material for MkDocs team. Package metadata now marks the project as inactive and includes maintenance and migration links.
Selected Python security advisories addressed by the new minimums:
| Dependency | Affected versions | New minimum | Advisory |
|---|---|---|---|
| Jinja2 | <=3.1.5 |
3.1.6 |
CVE-2025-27516 |
| Markdown | <3.8.1 |
3.8.1 |
CVE-2025-69534 |
| Pygments | <2.20.0 |
2.20.0 |
CVE-2026-4539 |
| PyMdown Extensions | <=11.0.0 |
11.0.1 |
CVE-2026-67422 |
| Requests | <2.33.0 |
2.33.0 |
CVE-2026-25645 |
| Pillow | <13.0.0 |
13.0.0 |
CVE-2026-96636 |
| CairoSVG | <=2.9.0 |
2.9.1 |
CVE-2026-107378 |
| GitPython | <=3.2.0 |
3.2.1 |
CVE-2026-114145 |
Pillow and CairoSVG apply to the imaging extra; GitPython applies to the git extra.
Fixed a DOM-based XSS vulnerability in search suggestions
[!WARNING]
Material for MkDocs is approaching end of life
Material for MkDocs is scheduled to reach end of life on November 5, 2026. Until then, maintenance is limited to critical bug fixes and security updates. After this date, the project will remain available on PyPI and GitHub, but no further maintenance is planned except in exceptional circumstances.
For users looking for a long-term, actively developed successor, we're building Zensical – a next-generation static site generator designed for technical documentation. If you're planning a new documentation project or evaluating your long-term options, we invite you to take a look.
Organizations requiring support beyond this date are welcome to get in touch to discuss available options.
Thanks to @p- for responsibly reporting this issue.
> __Material for MkDocs is in maintenance mode__
[!WARNING]
Material for MkDocs is in maintenance mode
Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
Material for MkDocs is in maintenance mode
Warning
Material for MkDocs is in maintenance mode
Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
Limited version range of mkdocs to <2
Updated MkDocs 2.0 incompatibility warning (clarify relation with MkDocs)
Material for MkDocs is in maintenance mode
Warning
Material for MkDocs is in maintenance mode
Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
Hardened social cards plugin by switching to sandboxed environment
Updated MkDocs 2.0 incompatibility warning
Material for MkDocs is in maintenance mode
Warning
Material for MkDocs is in maintenance mode
Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
Material for MkDocs is in maintenance mode
Warning
Material for MkDocs is in maintenance mode
Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
mkdocs build about impending MkDocs 2.0 incompatibility (doesn't affect strict mode)Opened up version ranges of optional dependencies for forward-compatibility
Added warning to mkdocs build about impeding MkDocs 2.0 incompatibility
Material for MkDocs is in maintenance mode
Warning
Material for MkDocs is in maintenance mode
Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
Note on deprecated plugins : The projects and typeset plugins are included in this release, but must be considered deprecated. Both plugins proved uns…
Warning
Material for MkDocs is now in maintenance mode
This is the last release of Material for MkDocs that will receive new features. Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs for 12 months at least.
This release includes all features that were previously exclusive to the Insiders edition. These features are now freely available to everyone.
Note on deprecated plugins: The projects and typeset plugins are included in this release, but must be considered deprecated. Both plugins proved unsustainable to maintain and represent architectural dead ends. They are provided as-is without ongoing support.
Changes:
Updated Burmese translation
Updated Georgian translation
Fixed #8458: Temporary pin of click dependency
Fixed #8446: Deprecation warning as of Python 3.14 in Emoji extension
& character not escaped in search highlightingUpdated Bahasa Malaysia translations
Updated Azerbaijani translations
Updated Azerbaijani translations
Fixed last compat issues with minijinja, now 100% compatible
Fixed #8396: Videos do not autoplay when inside a content tab
Fixed #8349: Info plugin doesn't correctly detect virtualenv in some cases
Improved semantic markup of "edit this page" button
Fixed #8215: Social plugin crashes when CairoSVG is updated to 2.8
Fixed #8204: Annotations showing list markers in print view
Fixed #8158: Flip footnote back reference icon for right-to-left languages
Updated Docker image to latest Alpine Linux
items not available (9.6.10 regression)This version is a pure refactoring release, and does not contain new features or bug fixes. It strives to improve the compatibility of our templates w
This version is a pure refactoring release, and does not contain new features or bug fixes. It strives to improve the compatibility of our templates with alternative Jinja-like template engines that we're currently exploring, including minijinja.
Additionally, it replaces several instances of Python function invocations with idiomatic use of template filters. All instances where variables have been mutated inside templates have been replaced. Most changes have been made in partials, and only a few in blocks, and all of them are fully backward compatible, so no changes to overrides are necessary.
Note that this release does not replace the Jinja template engine with minijinja. However, our templates are now 99% compatible with minijinja, which means we can explore alternative Jinja-compatible implementations. Additionally, immutability and removal of almost all Python function invocations means much more idiomatic templating.
Updated Serbo-Croatian translations
Fixed #8076: Privacy plugin crashes if HTTP download fails
Fixed #8056: Error in backrefs implementation (9.6.6 regression)
Fixed #8040: Privacy plugin not replacing exteral assets (9.6.5 regression)
regex package in search pluginFixed #8016: Tags listing not showing when when file name has spaces
Fixed #7985: Blog content sometimes not stretching to full width
Fixed rendering of arrow heads in Mermaid.js class diagrams
Fixed #7955: Excessively long words don't break on narrow screens
Fixed #7943: Tags plugin crashing due to merge error
Added support for allow lists in tags plugin
Fixed #7913: Social plugin renders attribute lists in page title
Adjusted title color in dark mode for all supported Mermaid.js diagrams
Fixed #7774: Disabling social cards doesn't work
Fixed #7750: Numeric tags break search
Thanks go to @perpil for their contributions
Added support for removing preload hints in privacy plugin
preload hints in privacy pluginThanks go to @nejch and @perpil for their contributions
Reduced size of Docker image through multi-stage build
Thanks go to @FrancoisCapon and @perpil for their contributions
Fixed #7672: Font CSS 404's when using privacy plugin (9.5.43 regression)
Thanks go to @nejch for their contributions.
Added support for external images in SVGs in privacy plugin
Thanks go to @nejch for their contributions
Fixed #7625: Invalid encoding of boolean attributes in privacy plugin
Fixed #7619: Improved tooltip on logo disappears after instant navigation
Fixed #7597: Social cards not using site name on home page
Thanks go to @pekkaklarck and @klejejs for their contributions
Fixed #7226: not staying on page when using mike's canonical versioning
Thanks go to @ilyagr for their contributions
Thanks go to @gerardkraja for their contributions
Thanks go to @gerardkraja for their contributions
Added 4th and 5th level ordered list styles
Added 4 th and 5 th level ordered list styles
Fixed #7548 : Tags have no spacing in search
Fixed #7544: Social cards incorrectly rendering HTML entities
Fixed #7498: Search not showing for Vietnamese language
Updated Mermaid.js to version 11 (latest)
Thanks go to @manselmi for their contributions
Fixed #7453: Incorrect position of tooltip when sorting table
Fixed RXSS vulnerability via deep link in search results
Thanks go to @joaopalmeiro for their contributions
Fixed #7405: DockerHub missing images > 9.5.27 due to change in Alpine/APK
Fixed #7380: Navigation icons disappearing on hover in Safari
Thanks go to @sisp for their contributions
Fixed #7362: Annotations in figure captions rendering incorrectly
Thanks go to @mmontes11 for their contributions
Fixed #7313: Improved tooltips mounted in sidebar when feature is disabled
Thanks to @Eilyre for their contributions
Thanks to @Eilyre for their contributions
Fixed #7232: Tab switches on scroll when linking tabs (9.5.19 regression)
Fixed #7209: Tags plugin crashing on numeric tags
One column per quarter.