Markdown to reStructuredText Converter
Convert Markdown to reStructuredText format instantly. Transform markdown syntax into RST for Sphinx documentation, Python project docs, and Read the Docs.
Continue Your Code Journey
What is Markdown to reStructuredText Converter?
The Markdown to reStructuredText Converter transforms Markdown syntax into RST format used by Sphinx and Python documentation tools. It converts headings to underline-style titles, links to RST reference syntax, code blocks to directive blocks, and lists to RST list format. All processing happens in the browser.
How does Markdown to reStructuredText Converter work?
This tool applies regex-based transformation rules to map Markdown syntax to reStructuredText. For example, # Heading becomes Heading with = underline, [text](url) becomes `text <url>`_, and ``` code ``` becomes .. code-block:: with indented content.
Key Features
- Converts headings with RST underlines
- Converts links to RST reference syntax
- Converts code blocks to code-block directives
- Converts lists, blockquotes, and tables
- Copy RST to clipboard
- Download as .rst file
- Real-time conversion
- Runs in the browser with no uploads
Common Use Cases
Migrating to Sphinx documentation
Convert Markdown README files to RST for Sphinx-based project documentation.
Publishing on Read the Docs
Transform Markdown content to RST format required by Read the Docs hosting.
Converting Python project docs
Convert Markdown documentation to RST for Python projects that use Sphinx.
Creating autodoc-compatible files
Prepare RST files with proper directives for Sphinx autodoc integration.
How to Use This Tool
Paste Markdown
Enter Markdown text in the input area.
Convert
Click Convert. The tool generates RST output.
Copy or download
Copy the RST or download it as a .rst file.
Pro Tips
- 1
RST uses underline characters (=, -, ~) beneath headings instead of # prefixes.
- 2
Links use `display text <url>`_ syntax instead of [text](url).
- 3
Code blocks use .. code-block:: language directives with indented content.
- 4
RST is whitespace-sensitive. Ensure proper indentation in the output.
Frequently Asked Questions
What Markdown elements are converted?
Headings, paragraphs, links, images, ordered and unordered lists, code blocks, blockquotes, tables, bold, italic, and inline code.
Is my content sent to a server?
No. All conversion happens in your browser. Nothing is transmitted.
Is the RST valid for Sphinx?
The output follows standard RST syntax. Review complex structures and add Sphinx directives as needed.
Can I convert RST back to Markdown?
This tool only converts Markdown to RST. Use a reverse converter for the other direction.
Does it handle GFM tables?
Yes. GFM pipe tables are converted to RST grid or simple table syntax.