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.
Complete Guide: Markdown to reStructuredText Converter
Everything you need to know about using this tool effectively
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.
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.
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.
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.
RST uses underline characters (=, -, ~) beneath headings instead of # prefixes.
Links use `display text <url>`_ syntax instead of [text](url).
Code blocks use .. code-block:: language directives with indented content.
RST is whitespace-sensitive. Ensure proper indentation in the output.
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.