NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1104 most downloaded on PyPI
Documentation that simply works
Last release 2 months ago
17 Jul 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
442 releases · first in 2016
Fixed #4000: Mermaid diagrams too dark in dark mode (8.3.0 regression)
Fixed #3987: Custom admonition icons don't work when defining color palette
Bump required Jinja version to 3.0.2
One column per quarter.
Added support for custom admonition icons
Fixed #3957: Only animate code annotations when visible (save CPU cycles)
Fixed spacing for code block results in content tabs
Fixed missing top right rounded border on admonition
4xx status codes not handled when using instant loadingFixed #3865: Tags index links to tagged pages 404 on Windows
Added support for GitHub-style hash fragments for dark/light images
Temporarily pinned Pygments to <2.12
Updated Mermaid.js to version 9.0.1
Mitigate flicker on color palette switch by disabling all transitions
Bumped MkDocs version to 1.3.0 to mitigate breaking changes in Jinja
Temporarily limit Jinja version range to < 3.1 due to breaking changes (see https://github.com/mkdocs/mkdocs/issues/2794)
Fixed #3695: Deprecation warning for unescaped backslashes in templates
Fixed #3596: Mermaid not working when headline with name 'Mermaid' present
Fixed malformed Google Fonts URL when a font setting was omitted
Fixed #3578: Active element in table of contents off-by-one on large screens
Added automatic removal of query parameter when search is closed
Fixed module material.plugins not being found (8.2.0 regression)
material.plugins not being found (8.2.0 regression)Added native support for Mermaid.js diagrams
Added Portuguese (Brasilian) translations
Added Portuguese (Brasilian) translations
Updated FontAwesome to v6 – check which icons were renamed here
Fixed #3545: Color palette toggle and search overlaying version selector
Fixed cutoff of very wide logos in the sidebar on mobile
Added support for `mkdocs.yml` validation and auto-complete
mkdocs.yml validation and auto-completeUpdated Giscus example integration with dynamic theme change support
Improved back-to-top button behavior - now not shown on anchor jump
Fixed spacing of blockquotes (8.1.5 regression)
Improved browser support: Chrome 49+, Safari 10+, Firefox 53+, Edge 79+
Added indicator to navigation expander icon
Added animation to active content tab indicator
Switched CSS sources to logical properties
ltr/rtl equivalentsAdded support for #only-light and #only-dark image hash fragments
#only-light and #only-dark image hash fragments:not() (Firefox 78 ESR)Added basic support for code block line anchors
+ signs to improve usabilityfont-size is increasedFixed #3302: Footer refactoring induced ellipsis in some browsers
Improved support for deeply nested code annotations
Removed deprecated google_analytics setting (was forgotten in 8.0.0)
google_analytics setting (was forgotten in 8.0.0)Fixed #3275: Code annotations always disappear on click
Improved rendering of code annotation markers
box-sizing for code annotations in detailsRemoved deprecated content tabs legacy implementation
copyright partial for easier overrideseealso admonition typesite_keywords setting (unsupported by MkDocs)extracopyright variable – use new copyright partial:is() selectors for simple selector listslast 4 years to last 2 yearsdetails when printingPlease see the upgrade guide
Switched to :is() selector for simple selector lists (main.css drops from 18kb to 16kb gzipped)
:is() selector for simple selector lists (main.css drops from 18kb to 16kb gzipped)p tags__Note: this is a beta release with several breaking changes__ – see #3219
Note: this is a beta release with several breaking changes – see #3219
seealso admonition typesite_keywords setting (unsupported by MkDocs)extracopyright variable (see upgrade guide)details when printingAdded support for adding titles to code blocks
Added support for setting table of contents title via mkdocs.yml
mkdocs.ymlBumped MkDocs version to 1.2.3 to mitigate [CVE-2021-40978]
Bumped MkDocs version to 1.2.3 to mitigate CVE-2021-40978
Fixed spacing issues when using integrate table of contents with tabs
Fixed some spacings issues for right-to-left languages
Fixed race condition in search initialization
Rewrite of entire documentation
Deprecated prebuilding of search index
file://Added new experimental content tabs implementation
Added support for sticky navigation tabs
Fixed #3039: Search modal overlays menu on mobile (7.2.7 regression)
Updated Serbian and Serbo-Croatian translations
Fixed rendering of blockquote elements (7.0.0 regression)
blockquote elements (7.0.0 regression)Updated Portuguese translations
Fixed #2926: Version selector not working (7.2.3 regression)
Slight facelift of data tables, now closer to Material Design
Fixed #2879: Search highlighting does not properly escape HTML
Fixed #2862: Back-to-top button overlays active search bar
Added support for search suggestions to save keystrokes
Updated Spanish and Galician translations
Refactored appearance of back-to-top button
Improved search language support for Thai and Hindi
Your coding agent can read these notes before it upgrades. Set up the MCP server →