# Changelog ## Material for MkDocs Insiders ### 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