reStructuredText to Markdown
Convert rst to markdown with pandoc. Runs entirely on your device.
Runs on your device. The file is never uploaded.
reStructuredText to Markdown converts an .rst file into pandoc Markdown, underlined sections becoming headings and literal blocks becoming fenced code. Directives with a counterpart, images and tables among them, become it, and the rest arrive as a fenced div written with three colons. Sphinx roles such as ref and doc are never resolved.
Questions
What happens to RST directives?
Directives with a Markdown counterpart, images, code blocks and tables among them, convert into that counterpart. Ones without, admonitions for example, might come through as a fenced div in pandoc's Markdown, written with three colons, or be dropped. Read the output rather than assuming; a directive your own toolchain defined is not one pandoc knows.
Why did my include directive not pull in the other file?
Because the tool passes pandoc the text of the single file you drop and nothing else. An include directive names a file that is not available to it, so the content it points at cannot appear. Convert the included files separately, or paste them together into one .rst first.
Are Sphinx roles like ref and doc resolved?
No. Those are Sphinx additions rather than standard reStructuredText, and resolving one means knowing about the rest of the documentation project, which this tool never sees. Expect them to come across as plain text or to disappear, and fix the cross-references by hand afterwards.
Which Markdown dialect comes out?
Pandoc's extended Markdown, which has syntax for tables, footnotes and definition lists that strict CommonMark lacks. That is what lets an RST document survive the trip with its structure intact, but it also means a few constructs will not render on a site that only accepts GitHub Markdown.
How do I convert Markdown to reStructuredText?
Use Markdown to reStructuredText. It handles the underlines, indentation and blank lines RST insists on, which is the fiddly part of writing RST by hand. The output file here is your name with the .md extension. Nothing is uploaded in either direction: pandoc runs as WebAssembly in a Web Worker in this tab, and each tool takes one file per run.