{"categories":[{"label":"Text Processing","url":"https://skillfed.io/packages/category/text-processing/2"}],"enrichment":{"capability":"Converts markdown files with embedded reStructuredText markup to valid reStructuredText format, supporting Sphinx integration for building documentation directly from markdown sources.","skillfed_tags":["sphinx-extension","markdown-conversion","documentation-tooling"],"use_cases":["Write Sphinx documentation in markdown while keeping rst directives and cross-references intact for the build.","Convert existing markdown README files to rst format for PyPI publication without losing formatting.","Include markdown files directly in Sphinx projects using the mdinclude directive alongside rst files.","Automate markdown-to-rst conversion in CI/CD pipelines for documentation generation.","Render mermaid diagram blocks in Sphinx when sphinxcontrib.mermaid is available."],"what_it_does":"M2R2 is a markdown-to-reStructuredText converter designed to let you write Sphinx documentation in markdown while preserving reStructuredText markup and Sphinx extensions that other converters drop. It extends the markdown parser mistune to handle inline and block-level rst constructs like directives, roles, and reference links, which would otherwise be lost in conversion. The package works both as a command-line tool and as a Sphinx extension that transparently converts .md files during documentation builds.\n\nThe core problem it solves is that standard markdown converters (pandoc, recommonmark) don't support many rst features\u2014particularly reference links and Sphinx-specific directives\u2014making them unsuitable for projects that rely on those capabilities. M2R2 is a maintained fork of the original m2r project, addressing issues that broke Sphinx 3 compatibility and keeping pace with modern Python versions (3.7\u20133.13).","worth_installing":"Yes. M2R2 is actively maintained, has no known vulnerabilities, low install friction, and solves a real problem for projects that need markdown authoring with full reStructuredText and Sphinx feature support. Install it if you want to write Sphinx docs in markdown without losing rst markup or Sphinx extensions."},"id":"m2r2","links":{"html":"https://skillfed.io/packages/m2r2","md":"https://skillfed.io/packages/m2r2.md","pypi":"https://pypi.org/project/m2r2/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2025-05-01","license_spdx":null,"license_treatment":"permissive","name":"m2r2","python_support":"supports_current","summary":"Markdown and reStructuredText in a single file."},"popularity":{"monthly_downloads":281198,"position":8103,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.3.4"}