Version 0.9.36 - 2026-03-15

In this release, we’ve invested heavily in revamping our documentation so that you can get from installation to your first useful scan more quickly. After the last release, a backlog review made it clear that our documentation needed an overhaul, especially for people seeing PyMarkdown for the first time. Over time, we added new sections and details without a full restructuring, which made it harder for new users to see where to start and how everything fits together.

We updated the main documentation and introduced new Quick Start guides for common workflows. We simplified each section and reorganized the content so related topics are grouped together and easier to follow. Each Quick Start guide focuses on a single topic, helping new users get productive with PyMarkdown as quickly as possible. New users can now go from install to scanning a repository in just a few minutes. Existing users should find it easier to jump straight to the commands and options they need.

Going forward, you can expect faster scans, clearer error reporting, and continued improvements to the documentation. To support that, our primary goal is to deliver requested features and respond quickly to reported issues, particularly in the rule set, configuration, and documentation. Behind the scenes, we are reducing skipped tests, working through backlogged issues, and investing in refactoring and performance analysis. This work helps keep PyMarkdown fast and dependable as it grows.

Added

• Issue 1511
  • Added plugins.per-file-ignores.* configuration items to allow for rules to be disabled by matching against a glob-path.
• Issue 1535
  • Added documentation under the extensions section to provide information on the tables extension.

Changed

• Issue 1527
  • Updated documentation to give more examples, including examples of TOML configurations.
• Issue 1539
  • Did full sweep through existing documentation, to clean up.
• Issue 1555
  • Badges were out of sync, needed new mechanism to properly fetch