NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #832 most downloaded on PyPI
readme_renderer is a library for rendering readme descriptions for Warehouse
Last release 1 months ago
28 Aug 2026
Ships unpredictably
gaps range from 2 weeks to 1.9 years
Nearly every release is documented
notes for 38 of 38 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
38 releases · first in 2016
docs: changelog date by @miketheman in #372
Full Changelog: 45.0...46.0
One column per quarter.
Render Markdown GFM alerts as semantic HTML admonitions (#374, #379)
Support GitHub emoji shortcodes in Markdown (#374)
Don't drop reStructuredText's top-level heading, and render headings at their literal levels starting at <h1>, consistent with Markdown (#377)
Require comrak 0.0.13 and higher for the md extra (#379)
Handle expected warnings in the test suite (#373)
Fix the 45.0 changelog date (#372)
Update workflows (#376, #381)
Allow class attribute on <pre> tags
cmarkgfm with comrak (#340)class attribute on <pre> tags (#365)python3 alias from Pygments (#320)clean() (#368):scale: image can't be sized (#359)Full Changelog: 44.0...45.0
Resolve Node 16 deprecation warnings in CI by @kurtmckee in #309
Full Changelog: 43.0...44.0
Drop support for Python 3.8 (#315)
Require docutils 0.21.2 and higher (#315)
Remove HTML5 <s> tag from the list of allowed HTML tags (#315)
Test all supported CPython and PyPy versions in CI (#315)
Resolve Node 16 deprecation warnings in CI (#309)
Lint specific directories (#312)
Build a wheel once for all tox test environments (#308)
Lazy open output files, and always close them (#314)
Gitpod: Migrate to the Even Better TOML extension (#306)
check-manifest: Remove a now-default .gitpod.yml exclusion (#307)
allow picture through by @mistwire in #299
Full Changelog: 42.0...43.0
Allow HTML5 picture tag through cleaner (#299)
Test against Python 3.12 (#300)
PEP 621 added by @apurvakhatri in #293
Full Changelog: 41.0...42.0
Migrate from bleach to nh3 (#295)
Migrate from setup.py to pyproject.toml
test: test our own readme by @miketheman in #288
Full Changelog: 40.0...41.0
Allow HTML5 figcaption tag through cleaner (#291)
Test README.rst from this project (#288)
test: add rst citations and footnote by @miketheman in #267
release.yml to use Trusted Publishing by @di in #276Full Changelog: 37.3...40.0
Add CLI option to render package README. (#271)
Adapt tests to pygments 2.14.0 (#272)
Update release process to use Trusted Publishing (#276)
Replace usage of deprecated pkg_resources with importlib.metadata (#281)
Drop support for Python 3.7 (#282), Test against Python 3.11 (#280)
fix: allow HTML5 figure tag through cleaner by @miketheman in #265
Full Changelog: 37.2...37.3
fix: allow HTML5 s tag through cleaner by @miketheman in #262
Full Changelog: 37.1...37.2
fix: allow HTML5 nav tag though filter by @miketheman in #259
Full Changelog: 37.0...37.1
test: confirm handling multiple inline strong by @miketheman in #252
Full Changelog: 36.0...37.0
First release by @miketheman ✨
Remove command line example from docs (#197)
Multiple pyproject.toml fixes (#251)
Confirm handling multiple inline strong (#252)
Convert RST output to HTML5 (#253)
Add Typing to classifiers (#254)
Development tweaks - coverage reporting, actions updates (#255)
Add test confirming behavior with unknown lexers (#256)
feat(dev): enable gitpod development by @miketheman in https://github.com/pypa/readme_renderer/pull/238
colspan and rowspan attributes by @miketheman in https://github.com/pypa/readme_renderer/pull/245Full Changelog: https://github.com/pypa/readme_renderer/compare/35.0...36.0
Enable gitpod development (#238)
Allow rst admonitions to render (#242)
Add badges to README (#243)
Update codebase for modern Python (#244)
Fix table cell spans (#245)
Allow math directive in rst (#246)
Preserve lang attribute in pre (#247)
Add py.typed to the built wheel by @bhrutledge in https://github.com/pypa/readme_renderer/pull/228
py.typed to the built wheel by @bhrutledge in https://github.com/pypa/readme_renderer/pull/228Full Changelog: https://github.com/pypa/readme_renderer/compare/34.0...35.0
Add py.typed to the built wheel (#228)
Use isolated build for tox (#229)
Fix renderer ignore (#230)
Remove legacy check command and distutils (#233)
Emit a warning when no content is rendered (#231)
Drop support for Python 3.6 (#236)
Update html attribute order in tests (#235)
* Add static types
Add static types (#225)
* Support cmarkgfm>=0.8.0 (#224) * Support Python 3.10
Allow start attribute in ordered lists
Render disabled checkboxes from Markdown
* support cmarkgfm>=0.6.0
Drop support for Python 2 and 3.5
* Support Python 3.9
Support Python 3.9
Add support for align attribute rendering Markdown headers
Fix regression for image height/width
* Support Python 3.7 and 3.8 * Drop support for Python 3.4 * Require Pygments>=2.5.1
* Remove dependency on future.
*Breaking change*: Move the cmarkgfm dependency into an extra (#130). Users that want to render Markdown will need to install readme_render[md] instea…
cmarkgfm dependency into an extra (#130). Users that want to render Markdown will need to install readme_render[md] instead.Unify handling of SVG and other images in RST.
Add specific tests for the raw directive.
<caption>. (#105)<p> tags (#98)Reformat docutils messages into more human-friendly output.
Allow details and summary tags.
Change Github-flavored Markdown identifier from gfm to GFM.
gfm to GFM.Add support for GitHub-flavored Markdown.
All renderers now accept arbitrary kwargs for future-proofing.
All renderers now accept arbitrary kwargs for future-proofing.
Gracefully handle new exceptions from bleach.
Gracefully handle new exceptions from bleach.
Fix an issue cleaning plaintext values.
Fix an issue cleaning plaintext values.
Fix an issue attempting to clean data that had tags without a href.
Fix an issue attempting to clean data that had <a> tags without a href.
* Fix issue with bleach >= 2.0.
Fix issue with bleach >= 2.0.
Fix issue with docutils >= 0.13.1.
Fix issue with docutils >= 0.13.1.
Renamed to readme_renderer: https://github.com/pypa/readme_renderer to work around an name overlap with README files shipped in Python's default site-
Renamed to readme_renderer: https://github.com/pypa/readme_renderer to work around an name overlap with README files shipped in Python's default site-packages directory on certain case-insensitive file systems.
Added PyPA Code of Conduct.
Allow <sub> and <sup> tags when cleaning rST HTML output.
Dropped support for Python 2.6.
Your coding agent can read these notes before it upgrades. Set up the MCP server →