Changelog

Material for MkDocs Insiders

4.53.17 August 22, 2025 { id="4.53.17" }

Fixed #8408: Code annotations bug with custom selectors

4.53.16 March 13, 2025 { id="4.53.16" }

Fixed #8019: Tooltips have precedence over instant previews

4.53.15 January 15, 2025 { id="4.53.15" }

Fixed #7896: Scoped tags listings not rendering in subsections

4.53.14 September 29, 2024 { id="4.53.14" }

Fixed #7567: Empty headlines when using typeset plugin with anchorlinks

4.53.13 September 14, 2024 { id="4.53.13" }

Fixed #7520: Social plugin errors for generated files (MkDocs 1.6+)

4.53.12 August 2, 2024 { id="4.53.12" }

Fixed #7410: Instant previews jump on content tabs with anchor links
Fixed #7408: Instant previews jump on content tabs

4.53.11 May 27, 2024 { id="4.53.11" }

Fixed projects plugin crashing when serving before building subprojects

4.53.10 May 20, 2024 { id="4.53.10" }

Fixed projects plugin crashing in serve mode when disabled
Fixed projects plugin crashing when building nested projects

4.53.9 May 20, 2024 { id="4.53.9" }

Fixed #7191: Tags listings not rendering when toc_depth is changed

4.53.8 April 26, 2024 { id="4.53.8" }

Fixed #7052: Preview extension automatically including all pages
Fixed #7051: Instant previews mounting on footnote references
Fixed #5165: Improved tooltips not mounting in sidebar for typeset plugin

4.53.7 April 25, 2024 { id="4.53.7" }

Fixed #7060: Incorrect resolution of translation when using static-i18n

4.53.6 April 5, 2024 { id="4.53.6" }

Ensure working directory is set for projects when using projects plugin
Fixed #6970: Incorrect relative paths in git submodules with projects plugin

4.53.5 April 2, 2024 { id="4.53.5" }

Fixed social plugin crashing when no colors are specified in palettes

4.53.4 March 31, 2024 { id="4.53.4" }

Fixed #6973: Escaping issue in tags extra files deprecation helper

4.53.3 March 23, 2024 { id="4.53.3" }

Added support for font variants in social plugin
Improved resilience of font resolution in social plugin
Fixed tag listing sometimes not being auto-populated
Fixed tag listing scope not being correctly resolved
Fixed #6941: Meta plugin adding duplicate entries
Fixed #6928: Social plugin crashes for some fonts

4.53.2 March 18, 2024 { id="4.53.2" }

Fixed abort on first non-matching configuration in preview extension
Fixed #6914: Meta files take precedence over front matter

4.53.1 March 6, 2024 { id="4.53.1" }

Fixed #6877: Projects plugin computes incorrect path to assets
Fixed #6869: Blog plugin should emit warning on invalid related link

4.53.0 February 24, 2024 { id="4.53.0" }

Added support for automatic instant previews
Added support for pinned blog posts

4.52.3 February 21, 2024 { id="4.52.3" }

Fixed resolution of URLs in instant previews
Fixed instant previews not mounting for same-page links

4.52.2 February 7, 2024 { id="4.52.2" }

Fixed #6735: Instant previews misplaced when below tabs

4.52.1 January 30, 2024 { id="4.52.1" }

Fixed #6705: Navigation path not being hidden when specified
Fixed #6703: New tags plugin crashes on Windows (2nd attempt)

4.52.0 January 28, 2024 { id="4.52.0" }

Added support for instant previews
Fixed footnote tooltips positioning edge cases
Fixed #6703: New tags plugin crashes on Windows

4.51.0 January 24, 2024 { id="4.51.0" }

Added support for footnote tooltips

4.50.0 January 19, 2024 { id="4.50.0" }

Added configurable logging capabilities to privacy plugin

4.49.2 January 9, 2024 { id="4.49.2" }

Fixed missing attribute lists extension for tags plugin
Fixed #6627: New tags plugin crashes on Python 3.8

4.49.1 January 7, 2024 { id="4.49.1" }

Improved interop of new tags plugin with other plugins
Fixed #6594: Tags plugin doesn't work with mkdocs-macros plugin
Fixed #6569: Social plugin crashes if in different file system location

4.49.0 December 29, 2023 { id="4.49.0" }

Added support for exporting tags and mappings
Added support for disabling tags and/or listings or both
Fixed tag links from pages to listings on homepage

4.48.0 December 23, 2023 { id="4.48.0" }

Rewrite of tags plugin, now much more powerful
Added support for nested tags (tag hierarchies, e.g. foo/bar)
Added support for shadow tags (by list, prefix or suffix)
Added support for custom tag layouts and templates
Added support for hiding tags in table of contents
Added support for configurable inline tag listings
Added support for automatically linking to closest tag listing
Added support for scoped listings (limit to subsection of site)
Added support for multiple instances of tags plugin
Added support for changing front matter property and template variable
Added support for tag slugification format strings
Fixed #6510: Projects plugin out of memory on Linux (4.47.1 regression)
Fixed projects plugin not notifying plugins about serve mode
Fixed projects plugin skipping projects on prefix match
Deprecated tags_file and tags_extra_files settings
Modernized tags plugin code base

4.47.1 December 11, 2023 { id="4.47.1" }

Improved editing experience for projects plugin
Improved resilience of optimize and social plugin
Fixed race condition when writing manifest in optimize and social plugin
Fixed #6475: Logo not taking precedence over icon in social card
Fixed #6399: Projects plugin doesn't pick up added/removed projects
Fixed #6306: Projects plugin cache not correctly updated

4.47.0 December 8, 2023 { id="4.47.0" }

Added support for staying on page when switching languages
Added configurable logging capabilities to projects plugin
Removed temporary warning on blog plugin authors file format change
Fixed projects plugin logging messages twice on Linux systems
Fixed projects plugin trying to hoist theme assets of divergent themes
Fixed compatibility of optimize plugin and projects plugin
Fixed compatibility of social plugin and projects plugin
Fixed #6448: Code line selection broken for code blocks with custom ids
Fixed #6437: Projects plugin crashing for certain site URL configurations
Fixed #6414: Projects plugin doesn't prefix messages coming from projects

4.46.0 November 26, 2023 { id="4.46.0" }

Added support for author profiles in blog plugin
Fixed custom index pages yielding two navigation items (4.45.0 regression)

4.45.0 November 24, 2023 { id="4.45.0" }

Added support for sorting blog categories by post count or custom function
Improved tags plugin to generate Unicode-aware slugs by default
Fixed non-deterministic order of multiple authors in blog plugin

4.44.0 November 23, 2023 { id="4.44.0" }

Added pagination settings for archive pages in blog plugin
Added pagination settings for category pages in blog plugin

4.43.1 November 19, 2023 { id="4.43.1" }

Added third-party theme support in projects plugin, improving editing
Fixed #6360: Projects plugin crashes when theme is not Material for MkDocs
Fixed #6306: Projects plugin not reloading nested project configuration

4.43.0 November 5, 2023 { id="4.43.0" }

Added support for GitLab committers (document contributors)
Fixed #6264: Fixed compatibility with Python < 3.10
Fixed #6254: Meta plugin not applying meta files to blog posts

4.42.3 October 27, 2023 { id="4.42.3" }

Fixed #6251: Cards in grids cut off on very small screens
Fixed #6241: Using social plugin + static-i18n plugin errors

4.42.2 October 14, 2023 { id="4.42.2" }

Fixed #6186: Privacy plugin ignores hash fragments on images
Fixed #6180: Projects plugin crashing when adding or removing files

4.42.1 October 5, 2023 { id="4.42.1" }

Fixed spacing of related links in blog posts on small screens

4.42.0 September 19, 2023 { id="4.42.0" }

Added support for using git submodules in projects plugin
Added support for transforming project configurations
Improved resilience of optimize and blog plugin
Fixed optimize plugin crashing on .jpeg extension
Fixed project URLs not using site URLs in projects plugin

4.41.0 September 11, 2023 { id="4.41.0" }

Improved multi-instance support for optimize plugin
Added inclusion and exclusion patterns for optimize plugin
Added transparent keyword for color handling in social plugin
Changed default quality of PNGs to 3 in optimize plugin
Fixed #5979: meta file not detected in root of docs directory

4.40.4 September 4, 2023 { id="4.40.4" }

Fixed privacy plugin choking on boolean HTML5 attributes
Fixed wrapping of inline code blocks in typeset table of contents
Fixed blog plugin error when running under dirty reload

4.40.3 September 2, 2023 { id="4.40.3" }

Fixed #5946: Docker image missing pngquant for optimize plugin

4.40.2 August 31, 2023 { id="4.40.2" }

Added configurable error handling capabilities for social plugin
Fixed #5922: Blog plugin shows no posts when building a standalone blog
Fixed #5914: Tags plugin tags_extra_files errors (4.39.3 regression)
Fixed #5904: Blog plugin sometimes excludes files (4.40.1 regression)

4.40.1 August 27, 2023 { id="4.40.1" }

Fixed #5902: ResizeObserver polyfill not detected by privacy plugin
Fixed empty category pages in blog plugin (4.40.0 regression)

4.40.0 August 26, 2023 { id="4.40.0" }

Added logo, title and description options to social plugin default layouts
Fixed privacy plugin compatibility issue with Python < 3.10
Fixed #5896: Blog plugin errors when using custom index pages

4.39.3 August 24, 2023 { id="4.39.3" }

Fixed lxml dependency missing in Docker container (4.39.2 regression)

4.39.2 August 23, 2023 { id="4.39.2" }

Fixed color palette toggle being reversed (9.2.0 regression)

4.39.1 August 21, 2023 { id="4.39.1" }

Fixed git diff in tags plugin after merging back 9.2.0 changes

4.39.0 August 3, 2023 { id="4.39.0" }

Added support for hoisting theme media files when building projects
Added support for sorting pages on tags index for tags plugin
Added support for adding date of last update to blog posts
Fixed #5797: Parse error in typeset plugin (4.38.1 regression)

4.38.1 August 1, 2023 { id="4.38.1" }

Improved nested serve mode for projects plugin
Improved compat in privacy plugin with third-party plugins
Fixed #5790: Typeset plugin ignores data-toc-label attribute
Fixed #5778: Interplay of privacy plugin with git-revision-date-localized
Fixed #5773: Info plugin erroring when community edition is in beta

4.38.0 July 29, 2023 { id="4.38.0" }

Added projects plugin for building nested projects
Updated privacy plugin to new MkDocs API

4.37.1 July 28, 2023 { id="4.37.1" }

Updated MkDocs to 1.5.1
Fixed deprecation warning in social plugin due to MkDocs upgrade
Fixed #5772: Privacy plugin fails due to API change in MkDocs

4.37.0 July 7, 2023 { id="4.37.0" }

Added support for overriding social cards settings per page
Added new social card default/only/image layout
Improved resilience of optimize and social plugin
Fixed rendering bugs for pruned navigation items
Fixed jumping of content tabs anchor links when instant loading is enabled
Fixed #5676: Optimize plugin doesn't check for pngquant

4.36.1 June 23, 2023 { id="4.36.1" }

Fixed #5618: Date comparison breaking for drafts in blog plugin

4.36.0 June 15, 2023 { id="4.36.0" }

Added support for instant prefetching to speed up slow connections
Improved stability of anchor link removal in built-in typeset plugin
Improved performance of regular expressions in typeset plugin
Removed unnecessary import test for cairosvg in optimize plugin
Fixed #5590: Regular expression for anchor link removal too greedy

4.35.3 June 1, 2023 { id="4.35.3" }

Fixed #5579: Abbreviations in headlines filtered by typeset plugin

4.35.2 May 29, 2023 { id="4.35.2" }

Fixed #5555: Blog plugin crashes when computing readtime for emojis

4.35.1 May 20, 2023 { id="4.35.1" }

Fixed internal handling of errors in social plugin

4.35.0 May 20, 2023 { id="4.35.0" }

Improve editing experience and stability of social plugin
Added support for custom layout syntax validation in social plugin
Added support for layer origin for easier placement in social plugin
Added support for in- and exclusion patterns in social plugin
Catch and print syntax errors in custom layouts

4.34.1 May 16, 2023 { id="4.34.1" }

Disable social plugin debug mode by default on mkdocs build
Added warning in social plugin debug mode when font style couldn't be found
Set default concurrency of built-in multi-threaded plugins to CPUs - 1
Fixed #5521: Social plugin triggers race condition when downloading fonts
Fixed #5515: Social plugin crashes when concurrency is set to 1

4.34.0 May 14, 2023 { id="4.34.0" }

Added support for new overflow mode to auto-fit text in social plugin
Reduced subtle rendering bugs in (code) annotations due to subpixel rounding
Improved print styles for (code) annotation lists
Improved performance of social plugin, now 3x as fast
Improved interop of typeset plugin with MkDocstrings
Fixed logo location for variants of default template in social plugin
Fixed #5446: Built-in typeset plugin picks up headings in code blocks

4.33.2 May 12, 2023 { id="4.33.2" }

Fixed #5508: Social plugin crashes trying to copy cards on Docker/Windows
Fixed #5507: Social plugin crashes on serve when layouts folder doesn't exist
Fixed #5505: Social plugin trying to resolve logo in wrong location
Fixed #5496: Annotations with nested lists incorrectly mounted
Fixed #5493: Social plugin crashes on Python 3.8

4.33.1 May 9, 2023 { id="4.33.1" }

Added support for SVG background images in social plugin

4.33.0 May 8, 2023 { id="4.33.0" }

Added support for custom layouts for social plugin
Added support for background images for social cards

4.32.6 April 22, 2023 { id="4.32.6" }

Fixed #5336: Interplay of blog plugin with git-revision-date-localized

4.32.5 April 7, 2023 { id="4.32.5" }

Fixed #5322: Navigation tabs hoist nested page icons

4.32.4 March 24, 2023 { id="4.32.4" }

Fixed #5241: Built-in typeset plugin jams navigation for anchors in headings

4.32.3 March 9, 2023 { id="4.32.3" }

Fixed Docker image release workflow (9.1.0 regression)
Fixed #5159: Missing underline for abbreviations (9.1.0 regression)

4.32.2 February 23, 2023 { id="4.32.2" }

Fixed #5127: Privacy plugin not handling large number of occurrences
Fixed #5126: Privacy plugin breaks when replacing specific emojis

4.32.1 February 23, 2023 { id="4.32.1" }

Fixed code block spans interfering with copying
Fixed #5077: Privacy plugin breaks image alt text encoding
Fixed #5079: Privacy plugin removing rel=me on external links

4.32.0 February 19, 2023 { id="4.32.0" }

Added support for custom selectors for code annotations
Added support for code line range selection for better sharing

4.31.0 February 18, 2023 { id="4.31.0" }

Added support for table of contents on blog index and archive pages
Fixed #4512: Allow custom search field boosts (experimental)

4.30.2 February 13, 2023 { id="4.30.2" }

Fixed privacy plugin excludes not working (4.30.0 regression)

4.30.1 February 12, 2023 { id="4.30.1" }

Fixed privacy plugin not handling static templates (e.g. 404.html)

4.30.0 February 6, 2023 { id="4.30.0" }

Rewrite of privacy plugin for concurrency, now twice as fast
Added support for explicit inclusion for privacy plugin
Added optimization support for privacy plugin (+ optimize plugin)

4.29.0 January 21, 2023 { id="4.29.0" }

Added built-in optimize plugin for automatically compressing images
Switched reporting in built-in privacy plugin to info level

4.28.1 January 17, 2023 { id="4.28.1" }

Fixed built-in info plugin erroring for Insiders on version check
Fixed #4865: Navigation paths render bug when there's no top-level section
Fixed #4875: Added support for hiding navigation paths
Improved navigation path to not render for a single item

4.28.0 January 14, 2023 { id="4.28.0" }

Added support for navigation path (breadcrumbs)

4.27.1 December 20, 2022 { id="4.27.1" }

Fixed rendering of succeeding navigation items in typeset plugin
Fixed #4795: Built-in typeset plugin changes MkDocs' title precedence
Fixed #4724: Blog plugin not rendering integrate table of contents

4.27.0 December 20, 2022 { id="4.27.0" }

Added built-in typeset plugin to preserve formatting in sidebars
Added URL and table of contents support for blog categories

4.26.6 November 28, 2022 { id="4.26.6" }

Fixed #4683: Tags plugin crashes when a tag is empty

4.26.5 November 27, 2022 { id="4.26.5" }

Fixed #4632: Post excerpt title link doesn't point to top of the page

4.26.4 November 27, 2022 { id="4.26.4" }

Fixed redundant file extension when using privacy plugin

4.26.3 November 15, 2022 { id="4.26.3" }

Fixed #4637: Attachments w/o titles in related links error in blog plugin
Fixed #4631: Remote favicons not downloaded and inlined by privacy plugin

4.26.2 November 3, 2022 { id="4.26.2" }

Updated MkDocs to 1.4.2
Added support for tag compare functions when sorting on index pages
Fixed footnotes being rendered in post excerpts without separators
Fixed error in blog plugin when toc extension is not enabled
Fixed issues with invalid asset paths and linked post titles
Fixed #4572: Privacy plugin fails when symlinks cannot be created
Fixed #4545: Blog plugin doesn't automatically link headline to post
Fixed #4542: Blog plugin doesn't allow for multiple instances
Fixed #4532: Blog plugin doesn't allow for mixed use of date and datetime

4.26.1 October 22, 2022 { id="4.26.1" }

Improved reporting of configuration errors in tags plugin
Fixed #4515: Privacy plugin fails when site URL is not defined
Fixed #4514: Privacy plugin doesn't fetch Google fonts (4.26.0 regression)

4.26.0 October 18, 2022 { id="4.26.0" }

Refactored privacy plugin to prepare for new features
Added support for rel=noopener links in privacy plugin
Resolve encoding issues with blog and privacy plugin

4.25.5 October 16, 2022 { id="4.25.5" }

Updated MkDocs to 1.4.1
Added namespace prefix to built-in plugins
Updated content and header partial

4.25.4 October 9, 2022 { id="4.25.4" }

Fixed other path issues for standalone blogs (4.24.2 regression)

4.25.3 October 9, 2022 { id="4.25.3" }

Fixed #4457: Posts not collected for standalone blog (4.24.2 regression)

4.25.2 October 4, 2022 { id="4.25.2" }

Fixed #4452: Blog and tags plugin crash when specifying slugify function

4.25.1 October 3, 2022 { id="4.25.1" }

Updated mkdocs-rss-plugin in Dockerfile to fix MkDocs compat errors

4.25.0 October 2, 2022 { id="4.25.0" }

Added support for navigation subtitles
Added support for defining an allow list for built-in tags plugin
Added support for custom slugify functions for built-in tags plugin
Improved stability of search plugin when using --dirtyreload

4.24.2 October 1, 2022 { id="4.24.2" }

Updated MkDocs to 1.4
Fixed compatibility issues with MkDocs 1.4
Fixed incorrectly generated paths in privacy plugin
Fixed blog index page not showing navigation when using meta plugin

4.24.1 September 30, 2022 { id="4.24.1" }

Fixed #4430: build error when enabling consent without repository URL

4.24.0 September 27, 2022 { id="4.24.0" }

Added support for custom content on index pages (blog)
Added support for keeping content on paginated index pages (blog)
Added support for limiting categories in post excerpts (blog)
Added support for simple override of templates via front matter (blog)
Added icon in navigation for pages with encrypted content
Fixed #4396: Front matter of index pages not inherited by pagination (blog)
Improved performance by building post excerpts once (blog)

4.23.6 September 22, 2022 { id="4.23.6" }

Fixed #4389: Blog posts in first week of year in wrong archive
Fixed (= switched) footer previous and next links for blog posts

4.23.5 September 18, 2022 { id="4.23.5" }

Fixed #4367: Improved blog plugin date handling for MultiMarkdown syntax
Fixed #4374: Fixed invalid URLs of related links to other blog posts

4.23.4 September 14, 2022 { id="4.23.4" }

Fixed #4365: Recursion error in blog plugin due to deepcopy
Fixed path errors for blog plugin on Windows
Fixed publishing workflow in forked repositories

4.23.3 September 13, 2022 { id="4.23.3" }

Fixed previous and next page links for drafts of blog posts

4.23.2 September 13, 2022 { id="4.23.2" }

Fixed #4348: Blog plugin crashes on custom nav title
Fixed blog plugin crashing when category contained only drafts
Fixed rendering of content from blog index file

4.23.1 September 12, 2022 { id="4.23.1" }

Fixed #4345: Blog plugin errors with default settings

4.23.0 September 12, 2022 { id="4.23.0" }

Added blogging support via built-in blog plugin

4.22.1 September 7, 2022 { id="4.22.1" }

Fixed #4217: Tooltips in data tables render in wrong position

4.22.0 August 21, 2022 { id="4.22.0" }

Added support for navigation status

4.21.1 August 13, 2022 { id="4.21.1" }

Fixed #4176: Broken image when avatar is served by Gravatar
Fixed #4212: Deferred search initialization for file:// locations

4.21.0 July 17, 2022 { id="4.21.0" }

Added meta plugin: set front matter for all pages in a folder
Fixed #4114: Tags plugin fails if only tags_extra_files is set

4.20.1 July 11, 2022 { id="4.20.1" }

Fixed #4105: Tags plugin fails if tags_file is not set (4.20.0 regression)

4.20.0 July 7, 2022 { id="4.20.0" }

Added support for additional tags indexes
Fixed #4100: Tag icons not shown in tags index

4.19.2 July 4, 2022 { id="4.19.2" }

Fixed #4051: Privacy plugin fails if symlinking isn't allowed on Windows

4.19.1 June 25, 2022 { id="4.19.1" }

Added mkdocs-git-committers-plugin to Dockerfile
Added mkdocs-git-revision-date-localized-plugin to Dockerfile

4.19.0 June 24, 2022 { id="4.19.0" }

Added support for document contributors
Updated French translations for cookie consent

4.18.2 June 16, 2022 { id="4.18.2" }

Fixed #4026: Fixed tooltips not mounted for nested navigation links

4.18.1 June 14, 2022 { id="4.18.1" }

Fixed #3990: Chinese search highlighting not working on non-boundaries

4.18.0 June 11, 2022 { id="4.18.0" }

Added support for automatic dark/light mode
Fixed #4009: Privacy plugin uses invalid paths for file cache on Windows

4.17.2 June 5, 2022 { id="4.17.2" }

Added support for custom jieba dictionaries (Chinese search)

4.17.1 June 5, 2022 { id="4.17.1" }

Added support for cookie consent reject button
Added support for cookie consent custom button ordering
Fixed #3988: Content tab not focused after alternating anchor links

4.17.0 June 4, 2022 { id="4.17.0" }

Added support for content tabs anchor links (deep linking)
Fixed #3975: Detect composition events in search interface (Chinese)
Fixed #3980: Search plugin doesn't use title set via front matter

4.16.2 May 29, 2022 { id="4.16.2" }

Fixed #3961: Nested sections triggered build error for navigation tabs

4.16.1 May 28, 2022 { id="4.16.1" }

Switched feedback widget rating titles to tooltips
Improved contrast of link colors for light/dark color schemes
Fixed #3950: Sticky navigation tabs rendering broken (4.15.2 regression)
Fixed #3958: Links invisible when using white primary color

4.16.0 May 25, 2022 { id="4.16.0" }

Added support for navigation pruning
Fixed search results for non-segmented characters (4.15.2 regression)

4.15.2 May 22, 2022 { id="4.15.2" }

Removed workaround for abbr on touch devices (superseded by tooltips)
Fixed #3915: Improved Chinese search query segmentation
Fixed #3938: Fixed tooltips position for navigation titles with ellipsis

4.15.1 May 14, 2022 { id="4.15.1" }

Improved performance of element focus observables
Fixed #3531: Added prev/next buttons to content tabs
Fixed tooltip positioning when host element is hidden

4.15.0 May 8, 2022 { id="4.15.0" }

Added support for improved tooltips
Fixed #3785: Show tooltip on hover for overflowing navigation link

4.14.0 May 5, 2022 { id="4.14.0" }

Added Chinese language support to built-in search plugin
Fixed all-numeric page titles raising error in social plugin

4.13.2 April 30, 2022 { id="4.13.2" }

Improved caching of downloaded resources in privacy plugin
Fixed #3851: External images not downloaded by privacy plugin

4.13.1 April 25, 2022 { id="4.13.1" }

Fixed #3839: Tags plugin breaks without icons (4.13.0 regression)

4.13.0 April 24, 2022 { id="4.13.0" }

Added support for tag icons

4.12.0 March 27, 2022 { id="4.12.0" }

Added support for card grids and grid layouts
Fixed #3685: Annotations sometimes broken when using instant loading
Fixed #3742: Automatically add Mermaid.js when building for offline usage

4.11.0 March 6, 2022 { id="4.11.0" }

Added support for excluding external assets from privacy plugin

4.10.1 March 2, 2022 { id="4.10.1" }

Added missing build dependencies to Dockerfile
Fixed encoding issues in privacy plugin, now forcing UTF-8 encoding
Fixed #3624: Scroll to active navigation item unreliable in Firefox
Fixed #3642: Privacy plugin errors when font setting was omitted

4.10.0 February 27, 2022 { id="4.10.0" }

Added support for offline plugin (supersedes offline search support)
Improved built-in privacy plugin to download nested JavaScript assets
Refactored configuration of built-in privacy plugin

4.9.1 February 21, 2022 { id="4.9.1" }

Fixed #3610: missing lxml dependency for privacy plugin
Fixed error when charset is missing in content-type header

4.9.0 February 20, 2022 { id="4.9.0" }

Added privacy plugin: automatic downloading of external assets

4.8.3 February 13, 2022 { id="4.8.3" }

Fixed #3560: Mermaid diagrams don't render for file:// locations

4.8.2 February 10, 2022 { id="4.8.2" }

Fixed #3559: Mermaid diagrams don't render inside closed details

4.8.1 February 6, 2022 { id="4.8.1" }

Fixed jump back to top on mobile when using anchor following

4.8.0 February 6, 2022 { id="4.8.0" }

Added support for anchor following table of contents (= auto scroll)

4.7.2 February 2, 2022 { id="4.7.2" }

Fixed #3526: Transparent sidebar title due to Safari bug
Fixed #3528: Firefox sometimes clips text in flow chart diagrams

4.7.1 January 30, 2022 { id="4.7.1" }

Fixed #3506: Tags index not respecting title set via front matter

4.7.0 January 25, 2022 { id="4.7.0" }

Added native support for offline search

4.6.1 January 16, 2022 { id="4.6.1" }

Fixed #3459: Section index pages picking up wrong title

4.6.0 January 11, 2022 { id="4.6.0" }

Added support for annotations (outside of code blocks)

4.5.2 January 8, 2022 { id="4.5.2" }

Fixed #3440: Content tab indicator not moving when using linking
Fixed #3445: Content tab switch flickers/jitters when using linking

4.5.1 January 2, 2022 { id="4.5.1" }

Added support for setting initial state of cookie consent
Fixed #3396: Disappearing link in navigation due to Safari bug

4.5.0 December 16, 2021 { id="4.5.0" }

Added support for navigation icons

4.4.0 December 10, 2021 { id="4.4.0" }

Added support for code annotation anchor links (deep linking)
Added new code annotation syntax modifier to strip comment
Updated German translations for cookie consent

4.3.0 December 5, 2021 { id="4.3.0" }

Added support for custom fonts in social cards
Fixed #3300: Announcement bar reappearing when using instant loading

4.2.0 December 2, 2021 { id="4.2.0" }

Added support for dismissible announcement bar
Added support for named placeholders in feedback widget

4.1.0 November 30, 2021 { id="4.1.0" }

Added support for passing page title to feedback forms

4.0.0 November 28, 2021 { id="4.0.0" }

Removed deprecated content tabs legacy implementation
Removed deprecated seealso admonition type
Removed deprecated site_keywords setting (unsupported by MkDocs)
Removed deprecated prebuilt search index support
Removed deprecated web app manifest – use customization
Removed extracopyright variable – use new copyright partial
Removed Disqus integration – use customization
Switched to :is() selectors for simple selector lists
Switched autoprefixer from last 4 years to last 2 years
Improved CSS overall to match modern standards
Improved CSS variable semantics for fonts
Improved extensibility by restructuring partials
Improved handling of details when printing
Improved keyboard navigation for footnotes
Fixed #3214: Search highlighting breaks site when empty

3.2.3 November 20, 2021 { id="3.2.3" }

Updated Swedish and French translations
Removed support for .mermaid-experimental class (now .mermaid)
Fixed #3202: Cookie consent not dismissable on file:// locations
Fixed #3216: Cookie consent not dismissed when invoked via anchor
Fixed #3232: Mermaid.js sometimes runs twice (race condition)

3.2.2 November 6, 2021 { id="3.2.2" }

Fixed always last feedback rating being sent
Fixed #3145: Code annotations eat whole comment lines
Fixed #3170: Feedback widget doesn't send data to GA4

3.2.1 November 4, 2021 { id="3.2.1" }

Added support for custom Mermaid.js version via additional JavaScript
Fixed some configuration edge cases for tags plugin (3.1.5 regression)
Fixed feedback widget title not being centered in Firefox
Fixed #3179: Safari doesn't send request for feedback widget

3.2.0 October 31, 2021 { id="3.2.0" }

Added support for feedback widget (Was this page helpful?)

3.1.5 October 28, 2021 { id="3.1.5" }

Fixed #3144: Rogue link when using tags with auto-populated navigation
Fixed #3147: Code block line numbers appear in search results
Fixed #3158: Social cards do not strip HTML tags from title

3.1.4 October 17, 2021 { id="3.1.4" }

Fixed #2974: Text cropped with other fonts than Roboto in social plugin
Fixed #3099: Encoding problems with non-latin character in social plugin
Fixed #3112: Japanese segmenter not executed as part of new tokenizer
Fixed tags (front matter) appearing in search with disabled tags plugin

3.1.3 October 12, 2021 { id="3.1.3" }

Added warnings to search plugin for unsupported options and syntax
Fixed #3503: Search sometimes returns entire page
Fixed #3089: Single-line code annotations disappear when printing

3.1.2 October 6, 2021 { id="3.1.2" }

Fixed incorrect path separators for social cards on Windows

3.1.1 September 26, 2021 { id="3.1.1" }

Fixed ordering bug in search exclusion logic

3.1.0 September 26, 2021 { id="3.1.0" }

Added support for excluding pages, sections, and elements from search
Fixed #2803: Code block annotations not visible when printing

3.0.1 September 19, 2021 { id="3.0.1" }

Added support for using literal h1-6 tags for search plugin
Fixed search plugin breaking on void elements without slashes
Fixed search plugin filtering link contents from headlines
Fixed search plugin handling of multiple h1 headlines
Fixed search plugin handling of missing h1 headlines

3.0.0 September 13, 2021 { id="3.0.0" }

Rewrite of MkDocs' search plugin
Added support for rich search previews
Added support for tokenizer with lookahead
Improved search indexing performance (twice as fast)
Improved search highlighting

2.13.3 September 1, 2021 { id="2.13.3" }

Added support for disabling social card generation

2.13.2 August 25, 2021 { id="2.13.2" }

Fixed #2965: Social plugin error when primary color is not defined

2.13.1 August 21, 2021 { id="2.13.1" }

Fixed #2948: Social cards are not cached
Fixed #2953: Mermaid.js diagrams can't be centered anymore

2.13.0 August 7, 2021 { id="2.13.0" }

Added support for custom colors in social cards

2.12.2 August 4, 2021 { id="2.12.2" }

Fixed #2891: Division by zero error in social plugin

2.12.1 July 26, 2021 { id="2.12.1" }

Fixed error in social plugin when site_description was not set
Fixed error in social plugin for non-ASCII characters

2.12.0 July 25, 2021 { id="2.12.0" }

Added support for social cards

2.11.1 July 20, 2021 { id="2.11.1" }

Fixed order of tags index, now sorted alphabetically

2.11.0 July 18, 2021 { id="2.11.0" }

Improved Mermaid.js integration, now stable
Added support for sequence diagrams
Added support for entity relationship diagrams
Added support for cookie consent configuration
Added feature flag to always enable annotations

2.10.0 July 10, 2021 { id="2.10.0" }

Added support for cookie consent
Fixed #2807: Back-to-top button not hidden when using sticky tabs

2.9.2 May 30, 2021 { id="2.9.2" }

Moved tags to partial for easier customization
Added support for hiding tags on any page

2.9.1 May 24, 2021 { id="2.9.1" }

Added missing guard for linking of content tabs

2.9.0 May 23, 2021 { id="2.9.0" }

Added support for linking of content tabs

2.8.0 May 12, 2021 { id="2.8.0" }

Added support for boosting pages in search

2.7.2 May 8, 2021 { id="2.7.2" }

Fixed #2638: Warnings shown when using tags plugin without directory URLs

2.7.1 May 3, 2021 { id="2.7.1" }

Fixed git-revision-date-localized plugin integration (2.7.0 regression)

2.7.0 May 1, 2021 { id="2.7.0" }

Added support for tags (with search integration)

2.6.0 April 11, 2021 { id="2.6.0" }

Stay on page when switching versions

2.5.0 March 28, 2021 { id="2.5.0" }

Added support for version warning

2.4.0 March 20, 2021 { id="2.4.0" }

Added support for custom admonition icons
Fixed #2444: Code block annotations with extra comments have wrong index

2.3.1 March 14, 2021 { id="2.3.1" }

Fixed anchor offset for permalinks when using sticky navigation tabs

2.3.0 March 13, 2021 { id="2.3.0" }

Added support for back-to-top button

2.2.1 March 4, 2021 { id="2.2.1" }

Fixed #2382: Repository stats failing when no release tag is present

2.2.0 February 28, 2021 { id="2.2.0" }

Added support for code block annotations

2.1.0 February 26, 2021 { id="2.1.0" }

Added support for anchor tracking

2.0.0 February 24, 2021 { id="2.0.0" }

Migrated Insiders to the new architecture
Swapped color palette toggle configuration

1.17.0 January 31, 2021 { id="1.17.0" }

Added support for section index pages

1.16.1 January 26, 2021 { id="1.16.1" }

Fixed #2249: Instant loading + sticky tabs result in invalid links
Fixed #2248: Search highlighting URL parameter always added
Fixed #2235: Version selector doesn't select current version for aliases

1.16.0 January 7, 2021 { id="1.16.0" }

Added latest release to repository info (GitHub)
Slight facelift of repository info (lighter fonts, spacing and icons)

1.15.0 January 2, 2021 { id="1.15.0" }

Added support for native Mermaid.js integration

1.14.0 December 30, 2020 { id="1.14.0" }

Added support for sharing searches

1.13.2 December 22, 2020 { id="1.13.2" }

Fixed version selector + sticky tabs navigation rendering issues
Fixed version selector wrapping

1.13.1 December 20, 2020 { id="1.13.1" }

Removed horizontal scrollbars on language and version selector
Fixed type conversion in JavaScript config

1.13.0 December 13, 2020 { id="1.13.0" }

Refactored navigation tabs to simplify grouping behavior
Added support for sticky navigation tabs
Added support for arbitrary links in navigation tabs
Fixed #2098: Subsequent active subsection not highlighted correctly

1.12.1 December 8, 2020 { id="1.12.1" }

Fixed empty language selector being shown

1.12.0 December 6, 2020 { id="1.12.0" }

Added support for adding a language selector

1.11.2 November 29, 2020 { id="1.11.2" }

Fixed #2068: Search highlight interprets code blocks as JavaScript

1.11.1 November 29, 2020 { id="1.11.1" }

Refactored styling to be more stable and easier to adjust
Fixed some styling regressions from latest features

1.11.0 November 22, 2020 { id="1.11.0" }

Added support for rendering admonitions as inline blocks

1.10.0 November 15, 2020 { id="1.10.0" }

Added support for integrating table of contents into navigation

1.9.0 November 7, 2020 { id="1.9.0" }

Added support for hiding navigation and table of contents on any page
Removed autohiding table of contents when empty

1.8.0 November 1, 2020 { id="1.8.0" }

Added support for navigation sections
Fixed appearance of inactive search suggestions

1.7.0 October 25, 2020 { id="1.7.0" }

Added support for deploying multiple versions
Fixed alignment of sidebar when content area is too small

1.6.0 October 11, 2020 { id="1.6.0" }

Added support for search suggestions to save keystrokes
Added support for removing Made with Material for MkDocs from footer
Fixed #1915: search should go to first result by pressing ++enter++

1.5.1 September 21, 2020 { id="1.5.1" }

Fixed content area stretching to whole width for long code blocks

1.5.0 September 19, 2020 { id="1.5.0" }

Added support for autohiding table of contents when empty

1.4.1 September 6, 2020 { id="1.4.1" }

Improved typeahead and search result relevance and scoring

1.4.0 August 30, 2020 { id="1.4.0" }

Added support for autohiding header on scroll

1.3.0 August 26, 2020 { id="1.3.0" }

Added support for user-selectable color palettes

1.2.0 August 11, 2020 { id="1.2.0" }

Added feature to expand navigation by default

1.1.0 August 3, 2020 { id="1.1.0" }

Added highlighting of search results

1.0.0 July 14, 2020 { id="1.0.0" }

Added grouping of search results
Added missing query terms to search result
Improved search result relevance and scoring

Changelog

Changelog

Material for MkDocs Insiders

4.53.17 <small>August 22, 2025</small> { id="4.53.17" }

4.53.16 <small>March 13, 2025</small> { id="4.53.16" }

4.53.15 <small>January 15, 2025</small> { id="4.53.15" }

4.53.14 <small>September 29, 2024</small> { id="4.53.14" }

4.53.13 <small>September 14, 2024</small> { id="4.53.13" }

4.53.12 <small>August 2, 2024</small> { id="4.53.12" }

4.53.11 <small>May 27, 2024</small> { id="4.53.11" }

4.53.10 <small>May 20, 2024</small> { id="4.53.10" }

4.53.9 <small>May 20, 2024</small> { id="4.53.9" }

4.53.8 <small>April 26, 2024</small> { id="4.53.8" }

4.53.7 <small>April 25, 2024</small> { id="4.53.7" }

4.53.6 <small>April 5, 2024</small> { id="4.53.6" }

4.53.5 <small>April 2, 2024</small> { id="4.53.5" }

4.53.4 <small>March 31, 2024</small> { id="4.53.4" }

4.53.3 <small>March 23, 2024</small> { id="4.53.3" }

4.53.2 <small>March 18, 2024</small> { id="4.53.2" }

4.53.1 <small>March 6, 2024</small> { id="4.53.1" }

4.53.0 <small>February 24, 2024</small> { id="4.53.0" }

4.52.3 <small>February 21, 2024</small> { id="4.52.3" }

4.52.2 <small>February 7, 2024</small> { id="4.52.2" }

4.52.1 <small>January 30, 2024</small> { id="4.52.1" }

4.52.0 <small>January 28, 2024</small> { id="4.52.0" }

4.51.0 <small>January 24, 2024</small> { id="4.51.0" }

4.50.0 <small>January 19, 2024</small> { id="4.50.0" }

4.49.2 <small>January 9, 2024</small> { id="4.49.2" }

4.49.1 <small>January 7, 2024</small> { id="4.49.1" }

4.49.0 <small>December 29, 2023</small> { id="4.49.0" }

4.48.0 <small>December 23, 2023</small> { id="4.48.0" }

4.47.1 <small>December 11, 2023</small> { id="4.47.1" }

4.47.0 <small>December 8, 2023</small> { id="4.47.0" }

4.46.0 <small>November 26, 2023</small> { id="4.46.0" }

4.45.0 <small>November 24, 2023</small> { id="4.45.0" }

4.44.0 <small>November 23, 2023</small> { id="4.44.0" }

4.43.1 <small>November 19, 2023</small> { id="4.43.1" }

4.43.0 <small>November 5, 2023</small> { id="4.43.0" }

4.42.3 <small>October 27, 2023</small> { id="4.42.3" }

4.42.2 <small>October 14, 2023</small> { id="4.42.2" }

4.42.1 <small>October 5, 2023</small> { id="4.42.1" }

4.42.0 <small>September 19, 2023</small> { id="4.42.0" }

4.41.0 <small>September 11, 2023</small> { id="4.41.0" }

4.40.4 <small>September 4, 2023</small> { id="4.40.4" }

4.40.3 <small>September 2, 2023</small> { id="4.40.3" }

4.40.2 <small>August 31, 2023</small> { id="4.40.2" }

4.40.1 <small>August 27, 2023</small> { id="4.40.1" }

4.40.0 <small>August 26, 2023</small> { id="4.40.0" }

4.39.3 <small>August 24, 2023</small> { id="4.39.3" }

4.39.2 <small>August 23, 2023</small> { id="4.39.2" }

4.39.1 <small>August 21, 2023</small> { id="4.39.1" }

4.39.0 <small>August 3, 2023</small> { id="4.39.0" }

4.38.1 <small>August 1, 2023</small> { id="4.38.1" }

4.38.0 <small>July 29, 2023</small> { id="4.38.0" }

4.37.1 <small>July 28, 2023</small> { id="4.37.1" }

4.37.0 <small>July 7, 2023</small> { id="4.37.0" }

4.36.1 <small>June 23, 2023</small> { id="4.36.1" }

4.36.0 <small>June 15, 2023</small> { id="4.36.0" }

4.35.3 <small>June 1, 2023</small> { id="4.35.3" }

4.35.2 <small>May 29, 2023</small> { id="4.35.2" }

4.35.1 <small>May 20, 2023</small> { id="4.35.1" }

4.35.0 <small>May 20, 2023</small> { id="4.35.0" }

4.34.1 <small>May 16, 2023</small> { id="4.34.1" }

4.34.0 <small>May 14, 2023</small> { id="4.34.0" }

4.33.2 <small>May 12, 2023</small> { id="4.33.2" }

4.33.1 <small>May 9, 2023</small> { id="4.33.1" }

4.33.0 <small>May 8, 2023</small> { id="4.33.0" }

4.32.6 <small>April 22, 2023</small> { id="4.32.6" }

4.32.5 <small>April 7, 2023</small> { id="4.32.5" }

4.32.4 <small>March 24, 2023</small> { id="4.32.4" }

4.32.3 <small>March 9, 2023</small> { id="4.32.3" }

4.32.2 <small>February 23, 2023</small> { id="4.32.2" }

4.32.1 <small>February 23, 2023</small> { id="4.32.1" }

4.32.0 <small>February 19, 2023</small> { id="4.32.0" }

4.31.0 <small>February 18, 2023</small> { id="4.31.0" }

4.30.2 <small>February 13, 2023</small> { id="4.30.2" }

4.30.1 <small>February 12, 2023</small> { id="4.30.1" }

4.30.0 <small>February 6, 2023</small> { id="4.30.0" }

4.29.0 <small>January 21, 2023</small> { id="4.29.0" }

4.28.1 <small>January 17, 2023</small> { id="4.28.1" }