Org to Markdown
Convert org to markdown with pandoc. Runs entirely on your device.
Runs on your device. The file is never uploaded.
Org to Markdown reads an Emacs .org file and writes Markdown, keeping headings, lists, links, tables and emphasis. Source blocks become fenced code with their language, and an existing results block travels as the text it already holds. Nothing inside a Babel block is executed, because this tool converts text and runs none of it.
Questions
What parts of my Org file survive?
The document structure does: headings, lists, links, tables, source blocks with their language, and emphasis. Org machinery that Markdown has no place for should not be assumed to survive, including TODO keywords, tags, priorities, property drawers and scheduling lines. Check the top of a converted file, where that machinery usually lives.
Are INCLUDE lines pulled in?
No. Only the file you drop is passed to pandoc, so an INCLUDE keyword names a file that is not available and its content does not appear. Export a single combined Org file from Emacs first, or convert each file separately.
Is code in Babel blocks executed?
Never. Source blocks are converted as text into fenced Markdown code blocks with the language kept, and nothing in them is run. Existing results blocks are converted as the text they already contain, not recomputed. That is worth saying plainly, because nothing on this site runs code out of a file you drop. The tools parse and rewrite text, and this one hands your Org document to pandoc and does nothing else with it.
Which Markdown dialect comes out?
Pandoc's extended Markdown, so Org tables become Markdown tables and footnotes stay footnotes. Some of that syntax is pandoc-specific and will not render on a site that accepts only GitHub Markdown, so skim the result before publishing it. A table formula line has no Markdown equivalent either, so the computed values come across as the plain cell text they already were in the Org file.
What is the output file, and how do I go back?
Your file name with the .md extension, shown on the page and offered as a download. Markdown to Org converts the other way and writes a .org file. Both run entirely on your device; the file is never uploaded. A round trip loses the Org-only machinery on the way in and gains nothing back on the way out, since Markdown asks for less than Org offers.