mdedit.ai logomdedit.ai

Markdown to RST

Convert Markdown to reStructuredText (RST) for Sphinx and Python docs.

This tool requires JavaScript. If you don't see the editor, enable JavaScript and reload.
Or from your terminalAutomate it with the API
npx mdedit-cli convert README.md --to rst

Same engine as this page. The command signs you in on first run.

Related conversions

Every other format this Markdown source can be converted to.

How to use Markdown to RST

  1. 1Upload a .md or .markdown file, or paste the source directly into the editor.
  2. 2Select “Convert” to build the .rst file.
  3. 3Copy the .rst result, or download it as a file.

Example

Convert Markdown to reStructuredText.

Input (Markdown)
# Release Notes

The importer now streams large files instead of buffering them in memory.

```bash
mdedit convert notes.md --to pdf
```

| Change | Status |
| --- | --- |
| Streaming import | Shipped |
| Retry on 429 | In review |
Output (.rst)
This is an example input for reStructuredText.

FAQ

What carries over from .md to .rst?
Structure maps across: headings, paragraphs, lists, links, tables, code blocks, and inline emphasis. Anything that depends on the source presentation layer can be simplified or dropped, including page layout, fonts and colors, comments and tracked changes, and deeply nested or merged tables. Review those areas before you publish the result.
What are the file limits?
Accepted file types are .md, .markdown. Each file must be 10 MB or smaller.
Is my content private?
Processed on mdedit.ai servers. Uploaded files are stored in a private S3 bucket (not publicly readable). Uploads use signed URLs, and results are provided via time-limited signed download links. Files are automatically deleted after 30 days.