Repository navigation
Releases: squidfunk/mkdocs-material
Release list
mkdocs-material-9.8.0
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.
- Updated Node build-time dependencies to fix vulnerabilities
- Updated Python dependency minimums and required Python 3.11
- Removed RSS from recommended dependencies
- Updated project status and maintenance links
- Updated CLI notice with end-of-life and migration guidance
- Removed redirects from recommended dependencies
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.
mkdocs-material-9.7.7
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.
Changes
- Fixed a DOM-based XSS vulnerability in search suggestions
Thanks to @p- for responsibly reporting this issue.
mkdocs-material-9.7.6
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.
Changes
- Automatically disable MkDocs 2.0 warning for forks of MkDocs
mkdocs-material-9.7.5
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.
Changes
- Limited version range of mkdocs to <2
- Updated MkDocs 2.0 incompatibility warning (clarify relation with MkDocs)
mkdocs-material-9.7.4
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.
Changes
- Hardened social cards plugin by switching to sandboxed environment (recommended by @caveeroo)
- Updated MkDocs 2.0 incompatibility warning
Contributors
Assets 2
mkdocs-material-9.7.3
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.
Changes
- Fixed #8567: Print MkDocs 2.0 incompatibility warning to stderr
mkdocs-material-9.7.2
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.
Changes
- Opened up version ranges of optional dependencies for forward-compatibility
- Added warning to
mkdocs buildabout impending MkDocs 2.0 incompatibility (doesn't affect strict mode)
mkdocs-material-9.7.1
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.
Changes
- Updated requests to 2.30+ to mitigate CVE in urllib
- Fixed privacy plugin not picking up protocol-relative URLs
- Fixed #8542: false positives and negatives captured in privacy plugin
mkdocs-material-9.7.0
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:
- Added support for projects plugin (for compat, now deprecated)
- Added support for typeset plugin (for compat, now deprecated)
- Added support for pinned blog posts and author profiles
- Added support for customizing pagination for blog index pages
- Added support for customizing blog category sort order
- Added support for staying on page when switching languages
- Added support for disabling tags in table of contents
- Added support for nested tags and shadow tags
- Added support for footnote tooltips
- Added support for instant previews
- Added support for instant prefetching
- Added support for custom social card layouts
- Added support for custom social card background images
- Added support for selectable rangs in code blocks
- Added support for custom selectors for code annotations
- Added support for configurable log level in privacy plugin
- Added support for processing of external links in privacy plugin
- Added support for automatic image optimization via optimize plugin
- Added support for navigation paths (breadcrumbs)
- Fixed #8519: Vector accents do not render when using KaTeX
mkdocs-material-9.6.23
- Updated Burmese translation
