NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1349 most downloaded on PyPI
A Python handler for mkdocstrings.
Last release 18 days ago
31 Aug 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
104 releases · first in 2021
One column per quarter.
Prevent alias resolution error when source-ordering members (67df10c by Timothée Mazzucotelli). Issue griffe#213
<small>Compare with 1.7.1</small>
Stop propagation of annotation to next parameter in signature template (3a760ac by Timothée Mazzucotelli). Issue #110
<small>Compare with 1.7.0</small>
__init__ methods when merging docstrings (b97d51f by Timothée Mazzucotelli). Issue #106Add option to unwrap Annotated types (53db04b by Timothée Mazzucotelli).
<small>Compare with 1.6.3</small>
Annotated types (53db04b by Timothée Mazzucotelli).Make load_external_modules a global-only option (266f41f by Timothée Mazzucotelli). Issue #87
<small>Compare with 1.6.2</small>
load_external_modules a global-only option (266f41f by Timothée Mazzucotelli). Issue #87Don't render cross-ref spans when they're not enabled (eed51ee by Timothée Mazzucotelli).
<small>Compare with 1.6.1</small>
Fix spacing for rendered named items in Yields, Receives and Returns sections (list style) (e12688e by Timothée Mazzucotelli).
Add doc-signature CSS class to separate signature code blocks (b6c648f by Timothée Mazzucotelli).
<small>Compare with 1.5.2</small>
doc-signature CSS class to separate signature code blocks (b6c648f by Timothée Mazzucotelli).format_attribute filter, preparing for cross-refs in attribute signatures (8f0ade2 by Timothée Mazzucotelli).Regression in children template: fix condition for when members are specified (beeebff by Timothée Mazzucotelli). Issue #100
<small>Compare with 1.5.1</small>
Never show full path in separate signature since it would appear in the heading already (9e02049 by Timothée Mazzucotelli).
<small>Compare with 1.5.0</small>
Add support for new Griffe docstring sections: modules, classes, and functions (methods) (d5337af by Timothée Mazzucotelli).
<small>Compare with 1.4.0</small>
Deprecate crossref and multi_crossref filters (4fe3d20 by Timothée Mazzucotelli).
<small>Compare with 1.3.0</small>
crossref and multi_crossref filters (4fe3d20 by Timothée Mazzucotelli).Set upper bound on Griffe (0.33) (ad8c2a3 by Timothée Mazzucotelli). See https://github.com/mkdocstrings/griffe/discussions/195.
<small>Compare with 1.2.1</small>
Fix members ordering when members are specified with a boolean (c69f9c3 by Timothée Mazzucotelli). Issue #89
Add Jinja blocks to module, class, function and attribute templates (299fe48 by Timothée Mazzucotelli).
<small>Compare with 1.1.2</small>
Keep headings style consistent (CSS) (92032e5 by Timothée Mazzucotelli).
<small>Compare with 1.1.1</small>
Fix mkdocs and readthedocs themes support (14f18b2 by Timothée Mazzucotelli).
<small>Compare with 1.1.0</small>
Support custom templates through objects' extra data (8ff2b06 by Timothée Mazzucotelli). PR #70
<small>Compare with 1.0.0</small>
The signature of the [format_signature filter][mkdocstrings_handlers.python.do_format_signature] has changed. If you override templates in your projec
<small>Compare with 0.10.1</small>
The signature of the [format_signature filter][mkdocstrings_handlers.python.do_format_signature] has changed.
If you override templates in your project to customize the output,
make sure to update the following templates so that they use
the new filter signature:
class.htmlexpression.htmlfunction.htmlsignature.htmlYou can see how to use the filter in this commit's changes: f686f4e4.
We take this as an opportunity to go out of beta and bump the version to 1.0.0. This will allow users to rely on semantic versioning.
Format signatures with full-path names (685512d by Timothée Mazzucotelli).
<small>Compare with 0.10.0</small>
Add option to disallow inspection (40f2f26 by Nyuan Zhang). Issue #68, PR #69
Allow resolving alias to external modules (02052e2 by Gilad). PR #61, Follow-up of PR #60
<small>Compare with 0.8.3</small>
Change "unresolved aliases" log level to DEBUG (dccb818 by Timothée Mazzucotelli).
<small>Compare with 0.8.2</small>
Fix base directory used to expand globs (34cfa4b by Florian Hofer). PR #45
<small>Compare with 0.8.1</small>
Expand globs relative to configuration file path (0dc45ae by David Vegh). Issue #42, PR #43
<small>Compare with 0.8.0</small>
Add support for globs in paths configuration (29edd02 by Andrew Guenther). Issue #33, PR #34
<small>Compare with 0.7.1</small>
Fix rendering of / in signatures (3e927e4 by Timothée Mazzucotelli). Issue #25
<small>Compare with 0.7.0</small>
Stop using deprecated base classes (d5ea1c5 by Timothée Mazzucotelli).
<small>Compare with 0.6.6</small>
show_submodules by default (480d0c3 by Timothée Mazzucotelli).show_root_full_path for ToC entries (hidden headings) (8f4c853 by Timothée Mazzucotelli).Always hide self and cls parameters (7f579d1 by Timothée Mazzucotelli). Issue #7
<small>Compare with 0.6.5</small>
Don't escape signatures return annotations (ac54bfc by Timothée Mazzucotelli). Issue #6
<small>Compare with 0.6.4</small>
Fix rendering of signature return annotation (b92ba3b by Timothée Mazzucotelli). Issue #4
<small>Compare with 0.6.3</small>
Fix examples rendering (a06a7e3 by Timothée Mazzucotelli). Issue mkdocstrings/griffe#46
<small>Compare with 0.6.2</small>
Catch alias resolution errors (b734dd0 by Timothée Mazzucotelli).
<small>Compare with 0.6.1</small>
Don't pop from fallback config (bde32af by Timothée Mazzucotelli).
<small>Compare with 0.6.0</small>
Add option to merge __init__ methods' docstrings into their classes' docstrings (1b4d1c0 by Timothée Mazzucotelli).
<small>Compare with 0.5.4</small>
__init__ methods' docstrings into their classes' docstrings (1b4d1c0 by Timothée Mazzucotelli).Don't load additional modules during fallback (69b8e25 by Timothée Mazzucotelli).
<small>Compare with 0.5.3</small>
Allow passing null as docstring style (f526816 by Timothée Mazzucotelli). Issue #2
<small>Compare with 0.5.2</small>
Require at least mkdocstrings 0.18 (7abdda4 by Timothée Mazzucotelli).
<small>Compare with 0.5.1</small>
Depend on Griffe >= 0.11.1 (1303557 by Timothée Mazzucotelli).
<small>Compare with 0.5.0</small>
Allow changing docstring style of an object (39240c1 by Timothée Mazzucotelli).
<small>Compare with 0.4.1</small>
docstring_section_style option (774988e by Timothée Mazzucotelli).Fix docstring admonitions rendering (a24ae2e by Timothée Mazzucotelli).
<small>Compare with 0.4.0</small>
Use the new mkdocstrings_handlers namespace (23c9023 by Timothée Mazzucotelli).
<small>Compare with 0.3.0</small>
mkdocstrings_handlers namespace (23c9023 by Timothée Mazzucotelli).Support griffe 0.10 (28061de by Timothée Mazzucotelli).
<small>Compare with 0.2.0</small>
Depend on griffe >= 0.7.1 (34f7ebd by Timothée Mazzucotelli).
<small>Compare with 0.1.0</small>
show_signature rendering option (0f07c2e by Will Da Silva).Implement handler and add templates (dbb580a by Timothée Mazzucotelli).
<small>Compare with first commit</small>
Your coding agent can read these notes before it upgrades. Set up the MCP server →