NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1560 most downloaded on PyPI
A Python handler for mkdocstrings.
Last release 12 days ago
22 Sep 2026
Release timing varies
gaps range from 1 weeks to 3 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
105 releases · first in 2021
One column per quarter.
Improve inventory object types (incorrectly called roles in mkdocstrings) ( d754326 by Timothée Mazzucotelli). Issue-339 , PR-340
Make template existence test (for locale templates) faster ( c0424f2 by Timothée Mazzucotelli).
This tag was signed with the committer’s verified signature .
pawamoy Timothée Mazzucotelli
GPG key ID: 7F557506715E2F19
Verified Learn about vigilant mode .
Don't render environment paths in source block labels ( 84ba73e by Chris Wilson). Issue-333 , PR-338
Don't pass unsupported options to Griffe parsers ( 4b38b6b by Timothée Mazzucotelli). Issue-337
Allow relative cross-references to work in summaries ( abe2888 by Timothée Mazzucotelli). Issue-331
Display Methods instead of Functions for category headings inside classes ( 7bf8b98 by Timothée Mazzucotelli). Issue-330
Depend on griffelib instead of griffe ( 770a5f6 by Timothée Mazzucotelli).
This tag was signed with the committer’s verified signature .
pawamoy Timothée Mazzucotelli
GPG key ID: 7F557506715E2F19
Verified Learn about vigilant mode .
a0b99c5
This commit was signed with the committer’s verified signature .
pawamoy Timothée Mazzucotelli
GPG key ID: 7F557506715E2F19
Verified Learn about vigilant mode .
Fix aliases for parameters ( 0ae77a3 by Timothée Mazzucotelli). Issue-mkdocstrings-813
Don't ignore filters when category grouping is disabled ( 63aa1b0 by Timothée Mazzucotelli). Issue-324
Remove deprecated code for v2 ( c10afdb by Timothée Mazzucotelli).
Release scoped and relative cross-references ( 872afc5 by Timothée Mazzucotelli).
__all__ ordering feature (84aaebc by Timothée Mazzucotelli).Normalize spaces to underscores when passing object to rendering context using its kind as key ( 6f79be0 by Timothée Mazzucotelli). Issue-mkdocstrings
Don't show implementation signature of __init__ method when overloads_only is true and it is merged into the class (9ef620f by Timothée Mazzucotelli).
Support PEP 695 generics (dc8c3ad by Victor Westerhuis). PR-221, Co-authored-by: Timothée Mazzucotelli
<small>Compare with 1.17.0</small>
Deprecate locale option in favor of mkdocstrings' (17f71ba by Timothée Mazzucotelli). PR-288
<small>Compare with 1.16.12</small>
warn_missing_types and warnings (0e3bdb8 by Timothée Mazzucotelli). Issue-mkdocstrings-437skip_local_inventory option to prevent objects from being registered in the local objects inventory (e82c24f by Bartosz Sławecki). Issue-296, Issue-mkdocstrings-671, PR-297Only replace CSS class in first *highlighting* span (d57740f by Timothée Mazzucotelli). Issue-281
Fix highlighting for signature with known special names like __init__ (7f95686 by Timothée Mazzucotelli). Issue-mkdocstrings-757
<small>Compare with 1.16.10</small>
__init__ (7f95686 by Timothée Mazzucotelli). Issue-mkdocstrings-757Fix inventory base_url being ignored (8870eb9 by Stefan Mejlgaard). Issue-268, PR-269
Use toc_label option in a few missing places (337b46b by Timothée Mazzucotelli). Issue-267
Prevent infinite recursion by detecting parent-member cycles (f3917e9 by Timothée Mazzucotelli). Issue-griffe-368
<small>Compare with 1.16.7</small>
Prepare public filtering method feature (fde2019 by Timothée Mazzucotelli). Issue-78
Importing from submodules is now deprecated: the public API is fully exposed under the top-level mkdocstrings_handler.python module.
<small>Compare with 1.16.5</small>
Importing from submodules is now deprecated: the public API is fully exposed under the top-level mkdocstrings_handler.python module.
Prepare backlinks support (56bf627 by Timothée Mazzucotelli). Issue-153, PR-252
Fix de-duplication of summary sections (dc46ac9 by Timothée Mazzucotelli).
<small>Compare with 1.16.3</small>
Depend on mkdocstrings 0.28.3 (9fa4f16 by Timothée Mazzucotelli).
<small>Compare with 1.16.2</small>
mkdocstrings module (da2ba13 by Timothée Mazzucotelli).Depend on mkdocs-autorefs >= 1.4 and mkdocstrings >= 0.28.2 (ea1ab49 by Timothée Mazzucotelli).
<small>Compare with 1.16.1</small>
Give precedence to user-provided paths when they are already listed in sys.path (0f497d1 by Timothée Mazzucotelli). Issue-248
Add option to show/hide overloads (4a5ee10 by Pete Stenger). PR-250
Unwrap Annotated regardless of signature_crossrefs (d809f1a by Timothée Mazzucotelli). Issue-249
Support cross-referencing constructor parameters in instance attribute values (f07bf58 by Timothée Mazzucotelli).
<small>Compare with 1.14.6</small>
Nothing published for this version
Catch alias resolution errors when getting aliases for an identifier (0aaa260 by Timothée Mazzucotelli). Issue-358
Remove type from property docstring summary in summary sections (15f2cd4 by Uchechukwu Orji). PR-242
Deactivate Pydantic validation on Python 3.9 is eval-type-backport is not available (for modern typing syntax support) (0de0e5e by Timothée Mazzucotel
Let dataclass implement __init__ method, set extra fields in get_options (477b9e4 by Timothée Mazzucotelli).
<small>Compare with 1.14.2</small>
__init__ method, set extra fields in get_options (477b9e4 by Timothée Mazzucotelli).Deactivate Pydantic logic if v1 is installed instead of v2 (c5ecd70 by Timothée Mazzucotelli). Issue-240
Fix type errors with options during collection and docstring parsing (15ca6d8 by Timothée Mazzucotelli).
<small>Compare with 1.14.0</small>
Add heading and toc_label options (7cabacf by Yann Van Crombrugge). Issue-mkdocstrings-725, PR-236
<small>Compare with 1.13.0</small>
heading and toc_label options (7cabacf by Yann Van Crombrugge). Issue-mkdocstrings-725, PR-236force_inspection option to force dynamic analysis (83823be by Uchechukwu Orji). Issue-94, PR-231Allow using Ruff to format signatures and attribute values (d67215c by dm). PR-216
<small>Compare with 1.12.2</small>
show_signature_annotations option for attribute signatures in headings (e93d166 by Timothée Mazzucotelli). Issue-griffe-pydantic#9__init__ overloads when merging into class (af6fab3 by Timothée Mazzucotelli). Issue-212linenums config for pycon examples in docstrings (53eb82a by Timothée Mazzucotelli). Related-to-#192__init__ docstring into class docstring if such inherited method wasn't selected through the inherited_members configuration option (6c5b5c3 by Timothée Mazzucotelli). Issue-189* and ** outside of cross-references in signatures (c4506f0 by Timothée Mazzucotelli). Needed-for-PR-216Always render cross-references outside of signatures (73f11dc by Timothée Mazzucotelli). Issue-mkdocstrings#700
<small>Compare with 1.12.1</small>
Don't escape parameter default values (9dee4d4 by Timothée Mazzucotelli). Issue-191
Drop support for Python 3.8 (6615c91 by Timothée Mazzucotelli).
<small>Compare with 1.11.1</small>
Prepare relative_crossrefs and scoped_crossrefs insiders features (dd8b014 by Timothée Mazzucotelli).
<small>Compare with 1.11.0</small>
relative_crossrefs and scoped_crossrefs insiders features (dd8b014 by Timothée Mazzucotelli).Hook into autorefs to provide context around cross-ref errors (bb4be5b by Timothée Mazzucotelli).
<small>Compare with 1.10.9</small>
Explicitly depend on mkdocs-autorefs to be able to specify lower bound (2299ab5 by Timothée Mazzucotelli).
<small>Compare with 1.10.8</small>
Depend on Griffe 0.49 (a87dcad by Timothée Mazzucotelli).
<small>Compare with 1.10.7</small>
Include tests and all relevant files for downstream packaging in source distribution
<small>Compare with 1.10.6</small>
Update code for Griffe 0.48 (removing deprecation warnings) (eff10cc by Timothée Mazzucotelli). Issue-173
<small>Compare with 1.10.5</small>
Mix both previous checks for displaying objects: not imported or public (587963b by Timothée Mazzucotelli). Issue-294
Update code for Griffe 0.46 to avoid deprecation warnings (321b407 by Timothée Mazzucotelli).
<small>Compare with 1.10.3</small>
load_external_modules default value to None to support new default mode in Griffe (ae5896c by Timothée Mazzucotelli).Don't crash when rendering the source of an object whose lineno is none (64df00b by Timothée Mazzucotelli). Issue-163
Actually make use of custom .html.jinja templates (5668abb by Timothée Mazzucotelli).
<small>Compare with 1.10.1</small>
…stating that extending *.html templates is deprecated (e6f1b9c by Timothée Mazzucotelli). Issue-151
<small>Compare with 1.10.0</small>
once when logging messages (2bc156b by Timothée Mazzucotelli).*.html top-level templates to extend the *.html.jinja base templates (a8c540e by Timothée Mazzucotelli). Issue-151*.html base templates to extend their *.html.jinja counterpart, while overriding the logs block to issue a logging message (info) stating that extending *.html templates is deprecated (e6f1b9c by Timothée Mazzucotelli). Issue-151*.html.jinja top-level (overridable) templates, extending their base counterpart (7c14924 by Timothée Mazzucotelli). Issue-151*.html.jinja base templates, which are copies of *.html templates, with an additional logs block, and using the updated get_template filter (eced9a5 by Timothée Mazzucotelli). Issue-151get_template filter to support both *.html and *.html.jinja templates, logging a message (info) when *.html templates are overridden by users (3546fd7 by Timothée Mazzucotelli). Issue-151Add CSS classes doc-section-title and doc-section-item in docstring sections (d6e1d68 by Timothée Mazzucotelli). Issue-17
<small>Compare with 1.9.2</small>
doc-section-title and doc-section-item in docstring sections (d6e1d68 by Timothée Mazzucotelli). Issue-17Remove cap on Python-Markdown 3.6 now that ToC labels are fixed by mkdocstrings (0c1e2c1 by Timothée Mazzucotelli).
<small>Compare with 1.9.1</small>
Don't try loading packages from relative paths (bd73497 by Timothée Mazzucotelli). Issue-145
Add upper bound on Python-Markdown 3.6 to temporarily prevent breaking changes (cd93ee3 by Timothée Mazzucotelli).
<small>Compare with 1.8.0</small>
show_labels option to show/hide labels (eaf9b82 by Viicos). Issue #120, PR #130Release Insiders features of the $500/month funding goal (bd30106 by Timothée Mazzucotelli). The features and projects related to *mkdocstrings-python
<small>Compare with 1.7.5</small>
Release Insiders features of the $500/month funding goal (bd30106 by Timothée Mazzucotelli). The features and projects related to mkdocstrings-python are:
griffe-inherited-docstrings, a Griffe extension for inheriting docstrings
griffe2md, a tool to output API docs to Markdown using Griffe
See the complete list of features and projects here: https://pawamoy.github.io/insiders/#500-plasmavac-user-guide.
Add missing translations (fallback theme) for ReadTheDocs (2fb6513 by Timothée Mazzucotelli). Issue #115
<small>Compare with 1.7.4</small>
Make extension paths relative to config file (5035e92 by Waylan Limberg). PR #112, Co-authored-by: Timothée Mazzucotelli
<small>Compare with 1.7.3</small>
Your coding agent can read these notes before it upgrades. Set up the MCP server →