mdedit.ai logomdedit.ai

reStructuredText to Markdown

Convert reStructuredText (RST) to Markdown for GitHub, docs, and READMEs.

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 docs.rst --to md

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

Related conversions

Every other format this reStructuredText source can be converted to.

How to use reStructuredText to Markdown

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

Example

Convert reStructuredText to Markdown.

Input (reStructuredText)
This is an example input for reStructuredText.
Output (.md)
# 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 |

FAQ

What carries over from .rst to .md?
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 .rst. 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.