mkdocs-material

> [!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. > > [Read the full announcement on our blog]

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

Changes

• Fixed a DOM-based XSS vulnerability in search suggestions

> Thanks to @p- for responsibly reporting this issue.

> [!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. > > [Read the full announcement on our blog]

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

Changes

• Automatically disable MkDocs 2.0 warning for forks of MkDocs

> [!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. > > [Read the full announcement on our blog]

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

Changes

• Limited version range of mkdocs to <2
• Updated MkDocs 2.0 incompatibility warning (clarify relation with MkDocs)

> [!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. > > [Read the full announcement on our blog]

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

Changes

• Hardened social cards plugin by switching to sandboxed environment (recommended by @caveeroo)
• Updated MkDocs 2.0 incompatibility warning

> [!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. > > [Read the full announcement on our blog]

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

Changes

• Fixed #8567: Print MkDocs 2.0 incompatibility warning to stderr

> [!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. > > [Read the full announcement on our blog]

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

Changes

• Opened up version ranges of optional dependencies for forward-compatibility
• Added warning to mkdocs build about impending MkDocs 2.0 incompatibility (doesn't affect strict 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. > > [Read the full announcement on our blog]

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

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

> [!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. > > [Read the full announcement on our blog]

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

[Zensical]: https://zensical.org [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/ [projects]: https://squidfunk.github.io/mkdocs-material/plugins/projects/ [typeset]: https://squidfunk.github.io/mkdocs-material/plugins/typeset/

• Updated Burmese translation

• Updated Georgian translation

• Updated Serbian translations
• Fixed #8458: Temporary pin of click dependency

• Fixed #8446: Deprecation warning as of Python 3.14 in Emoji extension
• Fixed #8440: & character not escaped in search highlighting
• Fixed #8439: FontAwesome icons color not set in social cards (regression)

• Added support for Python 3.14
• Updated Bahasa Malaysia translations

• Updated Azerbaijani translations
• Fixed last compat issues with [minijinja], now 100% compatible

[minijinja]: https://github.com/mitsuhiko/minijinja

• Fixed #8396: Videos do not autoplay when inside a content tab
• Fixed #8394: Stroke width not effective in Mermaid.js diagrams
• Fixed disappearing version selector when hiding page title