# Convert reST to Markdown

> Convert reST to Markdown online for free. Runs entirely in your browser, so your files never leave your device. Fast batch conversion, no sign-up, no watermarks.

URL: https://www.converterrr.com/rst-to-md

- Runs in the browser with Pandoc (WASM): files are not uploaded, and no credits are used.
- Engines: Pandoc (WASM) (browser), Pandoc (cloud).
- API: available. `POST /api/v1/jobs` with `"output_format": "md"` (paid plans).
- More: [Document converter](https://www.converterrr.com/document-converter), [reST converter](https://www.converterrr.com/rst-converter).

## How to convert reST to Markdown

1. **Add your reST files.** Drag and drop reST files onto the converter, paste them, or click to browse. You can add several at once.
2. **Choose Markdown.** Markdown is already selected. Open Options if you want to change quality, size or metadata.
3. **Convert.** Click Convert. Your files are converted right in your browser in seconds.
4. **Download your Markdown.** Download each Markdown file, or everything at once as a ZIP.

## Good to know

- reST files are typically used for Python and Sphinx documentation, while Markdown is best for READMEs, documentation and notes.
- This conversion runs on Pandoc (WASM), running locally in your browser — nothing is uploaded and it works even on slow connections.

## reST vs Markdown

|  | reST | Markdown |
| --- | --- | --- |
| Full name | reStructuredText | Markdown |
| Type | Document | Document |
| Extensions | .rst | .md, .markdown |
| MIME type | text/x-rst | text/markdown |
| Best for | Python and Sphinx documentation | READMEs, documentation and notes |
| Properties | plain-text markup | plain-text markup, open standard |

**reST:** reStructuredText is the markup language behind Python's documentation and the Sphinx docs generator.

**Markdown:** Markdown is a lightweight plain-text syntax for headings, lists and links that's used across GitHub, docs sites and note apps.

The other way around: [convert Markdown to reST](https://www.converterrr.com/md-to-rst).

## Related conversions

- [Markdown to reST](https://www.converterrr.com/md-to-rst) (in the browser)
- [reST to DOCX](https://www.converterrr.com/rst-to-docx) (in the browser)
- [DOCX to Markdown](https://www.converterrr.com/docx-to-md) (in the browser)
- [reST to EPUB](https://www.converterrr.com/rst-to-epub) (in the browser)
- [EPUB to Markdown](https://www.converterrr.com/epub-to-md) (in the browser)
- [reST to TXT](https://www.converterrr.com/rst-to-txt) (in the browser)
- [CSV to Markdown](https://www.converterrr.com/csv-to-md) (in the browser)
- [reST to HTML](https://www.converterrr.com/rst-to-html) (in the browser)
- [TXT to Markdown](https://www.converterrr.com/txt-to-md) (in the browser)
- [HTML to Markdown](https://www.converterrr.com/html-to-md) (in the browser)
- [reST to ODT](https://www.converterrr.com/rst-to-odt) (in the browser)
- [ODT to Markdown](https://www.converterrr.com/odt-to-md) (in the browser)

## Convert reST to other formats

[reST to DOCX](https://www.converterrr.com/rst-to-docx), [reST to EPUB](https://www.converterrr.com/rst-to-epub), [reST to TXT](https://www.converterrr.com/rst-to-txt), [reST to HTML](https://www.converterrr.com/rst-to-html), [reST to ODT](https://www.converterrr.com/rst-to-odt), [reST to RTF](https://www.converterrr.com/rst-to-rtf), [reST to LaTeX](https://www.converterrr.com/rst-to-tex), [reST to IPYNB](https://www.converterrr.com/rst-to-ipynb), [reST to FB2](https://www.converterrr.com/rst-to-fb2), [reST to Typst](https://www.converterrr.com/rst-to-typ), [reST to AsciiDoc](https://www.converterrr.com/rst-to-adoc), [reST to Org](https://www.converterrr.com/rst-to-org), [reST to MediaWiki](https://www.converterrr.com/rst-to-wiki), [reST to OPML](https://www.converterrr.com/rst-to-opml), [reST to DocBook](https://www.converterrr.com/rst-to-docbook), [reST to Textile](https://www.converterrr.com/rst-to-textile), [reST to JATS](https://www.converterrr.com/rst-to-jats), [reST to Man](https://www.converterrr.com/rst-to-man)

## Convert other formats to Markdown

[DOCX to Markdown](https://www.converterrr.com/docx-to-md), [EPUB to Markdown](https://www.converterrr.com/epub-to-md), [CSV to Markdown](https://www.converterrr.com/csv-to-md), [TXT to Markdown](https://www.converterrr.com/txt-to-md), [HTML to Markdown](https://www.converterrr.com/html-to-md), [ODT to Markdown](https://www.converterrr.com/odt-to-md), [RTF to Markdown](https://www.converterrr.com/rtf-to-md), [LaTeX to Markdown](https://www.converterrr.com/tex-to-md), [IPYNB to Markdown](https://www.converterrr.com/ipynb-to-md), [FB2 to Markdown](https://www.converterrr.com/fb2-to-md), [TSV to Markdown](https://www.converterrr.com/tsv-to-md), [Typst to Markdown](https://www.converterrr.com/typ-to-md), [Org to Markdown](https://www.converterrr.com/org-to-md), [MediaWiki to Markdown](https://www.converterrr.com/wiki-to-md), [OPML to Markdown](https://www.converterrr.com/opml-to-md), [DocBook to Markdown](https://www.converterrr.com/docbook-to-md), [Textile to Markdown](https://www.converterrr.com/textile-to-md), [JATS to Markdown](https://www.converterrr.com/jats-to-md), [Man to Markdown](https://www.converterrr.com/man-to-md)

## reST to Markdown: frequently asked questions

### How do I convert reST to Markdown?

Drop your reST file onto the converter above, make sure Markdown is selected, and click Convert. When it's done, download the Markdown file — it usually takes a few seconds.

### Is it safe to convert reST to Markdown here?

Yes. reST to Markdown conversion happens entirely inside your browser using WebAssembly, so your file is never uploaded to any server.

### Is the reST to Markdown converter free?

Yes — free with no watermark. Signed-out visitors can convert 25 files a day, and a free account raises that to 250.

### Will converting reST to Markdown reduce quality?

No — Markdown preserves the content of your reST file as faithfully as the format allows.

### Can I convert multiple reST files at once?

Yes. Add up to 5 files at a time without an account, 10 with a free account and up to 500 on paid plans, then download them individually or as a single ZIP.

### Can I convert Markdown back to reST?

Yes — use our Markdown to reST converter. Note that converting back and forth between formats can't recover detail lost to lossy compression.