---
id: sphinx-markdown-builder
version: "0.6.10"
license: MIT
license_treatment: permissive
maintenance: active
---

# sphinx-markdown-builder — A Sphinx extension to add markdown generation support.

License: permissive · Maintenance: active · Downloads: 589.2K/mo

## What it is and what it does

sphinx-markdown-builder is a Sphinx extension that adds Markdown as an output format alongside Sphinx's standard HTML and other builders. Instead of generating only HTML documentation, you can use the sphinx-build command with the markdown builder to produce Markdown files directly from your reStructuredText source. It depends on Sphinx, tabulate, and docutils—all widely used documentation and data-processing libraries.

The extension is configured through your Sphinx conf.py file and supports several options to control output: anchor generation for section references, metadata injection (author, copyright, version), custom link prefixes and suffixes for cross-references, file extension customization, bullet-point style, and GitHub-flavored Markdown output. This makes it useful for projects that want to maintain documentation in both Markdown and HTML, or to generate Markdown for publishing to platforms like GitHub that natively render Markdown.

Use it for:

- Generate Markdown documentation from reStructuredText for publishing to GitHub or GitLab wikis.
- Maintain a single reStructuredText source and build both HTML and Markdown outputs in CI/CD pipelines.
- Convert existing Sphinx projects to Markdown format for use in static site generators or content management systems.
- Create Markdown API documentation with anchored section links for embedding in GitHub README files.
- Build Markdown versions of technical documentation for platforms that prefer or require Markdown input.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Sphinx extension that generates Markdown output from reStructuredText documentation, allowing you to build Markdown files alongside or instead of HTML using the standard sphinx-build command.

Yes. The package is actively maintained, has no known vulnerabilities, installs with low friction, and solves a real problem for projects that need Markdown output from Sphinx documentation. The MIT license is permissive. Install it if you need to generate Markdown from reStructuredText or want Markdown as an alternative Sphinx builder.

## Install

pip install sphinx-markdown-builder
uv add sphinx-markdown-builder
poetry add sphinx-markdown-builder

## Installing sphinx-markdown-builder

Before you install: Low friction: pure Python wheel with three stable runtime dependencies (sphinx, tabulate, docutils). Actively maintained with a recent release; last commit 2026-08-13.

License in practice: MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license in distributions.

Quickstart:

pip install sphinx-markdown-builder==0.6.10

# In conf.py:
extensions = ["sphinx_markdown_builder"]

# Then build:
sphinx-build -M markdown ./docs ./build

Requires Sphinx and its dependencies to be installed; works with Python 3.7 or later.

Verify before relying:

- Whether markdown output preserves all semantic information from reStructuredText (e.g., cross-references, directives, code highlighting).
- Compatibility with recent Sphinx versions beyond what the fact sheet indicates.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 589.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sphinx markdown output, convert rst to markdown, sphinx builder markdown, documentation markdown generation, sphinx extension markdown, rst markdown converter, sphinx docs to markdown, documentation-tooling, sphinx-extension, rst-to-markdown

[View on SkillFed](https://skillfed.io/packages/sphinx-markdown-builder) · [View on PyPI](https://pypi.org/project/sphinx-markdown-builder/)