RST to MD Converter

Convert RST (reStructuredText document) files to MD online, for free, with nothing to install.

To convert RST to MD, select or drop your .rst file above, check that MD is chosen as the output, and click Convert. This conversion runs on our server, and your files are deleted 72 hours later.

What is an RST file?

RST – reStructuredText document. reStructuredText is the plain text markup of Python documentation: headings are underlined, lists use dashes, and directives add tables, notes and code.

RST Converter →

What is an MD file?

MD – Markdown document. Markdown is plain text with a few marks (# for headings, ** for bold, - for lists) that tools turn into formatted pages. It is the usual format of README files, notes and documentation.

MD Converter →

How to convert RST to MD

  1. Click Select File, or drop your .rst files anywhere on this page. You can add several at once.
  2. Check that MD is chosen as the output format. On this page it is picked for you.
  3. Click Convert. When a file has to go to our server, the button says Upload and convert instead.
  4. Click Download next to each file when it's done.

RST vs MD: how they compare

RSTMD
LayoutFlowing textFlowing text
EditableYesYes
Created byDavid Goodger, 2001John Gruber and Aaron Swartz, 2004
Best forTechnical documentationNotes, documentation and writing for the web

Good to know

  • Headings, lists, tables, bold and italic are kept as Markdown; pictures in the document are not included.
  • The reStructuredText is converted by pandoc, which handles the standard markup; directives that need Sphinx are skipped.

Frequently asked questions

Is converting RST to MD free?

Yes. Everyone gets 25 free credits a day, with no account needed. Conversions on our server use one credit per started minute of work, so most cost a single credit. Credits reset at midnight UTC.

Are my RST files uploaded anywhere?

This conversion runs on our server, because it needs tools that do not run in a browser. Your file is sent over an encrypted connection, and both it and the result are deleted 72 hours after the conversion. The server has no internet access while it works on your file.

How large can the RST file be?

Up to 1 GB per file. This conversion runs on our server, which accepts files up to that size.

Will the MD look the same as the RST?

The text and structure are kept: headings, lists, tables, bold and italic. Exact page layout, fonts and spacing may differ, because MD is flowing text, not fixed pages.

Can I convert several RST files at once?

Yes. Add as many files as you like; they are converted one after another, and each one gets its own Download button.

Convert RST to other formats

Convert other documents to MD

All document formats

Updated