recommonmark
A docutils-compatibility bridge to CommonMark, enabling you to write CommonMark inside of Docutils & Sphinx projects.
Decision gist · record as of 2026-08-14
No. The package is abandoned (last commit 2021-05-18) and its maintainers explicitly recommend an alternative. While it has low install friction and no known vulnerabilities, the lack of ongoing maintenance means no compatibility fixes for current Sphinx versions and no security updates.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Sphinx and Docutils; abandoned since 2021-05-18 with no ongoing maintenance or security updates.
- Low install friction with a pure-Python wheel, but the package is abandoned as of 2021-05-18 with no maintenance since.
- The maintainers explicitly recommend a replacement for new projects.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions, though the abandoned status means no security or compatibility updates are forthcoming.
last release 2020-12-17 (2066 days) · last repo commit 2021-05-18 · 342 stars · archived
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,181,183 downloads/mo, #4,257 on PyPI
Alternatives
Verify before relying
pip install recommonmark
# In Sphinx conf.py:
extensions = ['recommonmark']
# Then write .md files alongside .rst in your documentation source.- Whether existing Sphinx projects using recommonmark will continue to work with current Sphinx versions without compatibility issues.
- Whether the AutoStructify component's advanced Markdown-to-reStructuredText transformations are still reliable for complex documentation.
What it is and what it does
recommonmark is a parser that lets Sphinx and Docutils projects write documentation in CommonMark (Markdown) instead of only reStructuredText. It acts as a bridge between the CommonMark syntax and Docutils' internal document model, allowing you to mix .md and .rst files in the same project and use Sphinx features like cross-references and auto-generated table of contents from Markdown headings.
The package includes AutoStructify, an optional component that can automatically transform Markdown into reStructuredText at build time, with support for features like automatic table-of-contents generation, math formulas, and embedded reStructuredText evaluation. However, the project is now deprecated and archived; its maintainers recommend using an alternative for new work.
Use it for
- Adding Markdown documentation files to an existing Sphinx project without rewriting everything in reStructuredText.
- Using AutoStructify to automatically generate table-of-contents and cross-reference structures from Markdown headings during the Sphinx build.
- Migrating documentation from a Markdown-based system to Sphinx while keeping Markdown as the source format during transition.
- Enabling teams familiar with Markdown to contribute to Sphinx-based documentation without learning reStructuredText syntax.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No.
The package is abandoned (last commit 2021-05-18) and its maintainers explicitly recommend an alternative. While it has low install friction and no known vulnerabilities, the lack of ongoing maintenance means no compatibility fixes for current Sphinx versions and no security updates.
Install
recommonmark on PyPI
Before you install
Low install friction with a pure-Python wheel, but the package is abandoned as of 2021-05-18 with no maintenance since. The maintainers explicitly recommend a replacement for new projects.
Requires Sphinx and Docutils; abandoned since 2021-05-18 with no ongoing maintenance or security updates.
License in practice
MIT license permits commercial and private use with minimal restrictions, though the abandoned status means no security or compatibility updates are forthcoming.
Quickstart
pip install recommonmark
# In Sphinx conf.py:
extensions = ['recommonmark']
# Then write .md files alongside .rst in your documentation source.Verify before relying
- Whether existing Sphinx projects using recommonmark will continue to work with current Sphinx versions without compatibility issues.
- Whether the AutoStructify component's advanced Markdown-to-reStructuredText transformations are still reliable for complex documentation.
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagescommonmarkdocutilssphinx |
| Maintenance | Abandoned 2,066 days since the last release |
| Last repo commit | repository archived |
| First released | |
| Downloads | 1,181,183 / month, #4,257 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT License |
Evidence: recommonmark-0.7.1-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “commonmark docutils bridge”
- recommonmarkEnables Sphinx and Docutils projects to parse and render CommonMark…
- myst-parserMyST-Parser extends CommonMark-compliant Markdown with syntax for…
- commonmarkParses Markdown text according to the CommonMark specification and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Sphinx packages
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
A Sphinx extension that outputs documentation in serialized HTML formats (JSON and pickle) alongside standard HTML.
Alabaster is a clean, responsive Sphinx theme for documentation that requires Python 3.10 or newer and Sphinx 6.2 or newer.
A Sphinx extension that generates HTML help files from reStructuredText documentation source.
A Sphinx extension that converts documentation source files into QtHelp format, enabling integration with Qt-based help systems and documentation viewers.
However, be aware that maintenance is dormant—if you rely on it long-term, monitor Sphinx compatibility and consider whether QtHelp remains the right format for your…
See also esbonio · sphinx-markdown-tables · myst-parser · sphinx_mdinclude · m2r2 · docutils · sphinx-markdown-builder · pybtex-docutils · rich-rst · intersphinx-registry