1001Ferramentas
🗂️ Converters

Markdown → Org-mode

Basic Markdown to Org-mode converter: asterisk headings (* ** ***), lists, links and #+BEGIN_SRC code blocks.

Org-mode:

Markdown to Org Mode

Org Mode is Emacs's note format and goes far beyond markup: agenda, task tracking, executable code blocks and export to several formats. Anyone migrating notes from another tool into Emacs needs to convert the Markdown they already have, and the syntax differences are large enough that pasting directly leaves the result unreadable.

Paste the Markdown and receive Org. Headings swap the hash for an asterisk, keeping the level count; strong emphasis becomes a single asterisk and light emphasis becomes a slash; links reverse order and gain the characteristic double bracket pair; and a fenced code block becomes the BEGIN_SRC and END_SRC pair, preserving the language declared on the opening fence, which is what makes Emacs highlight and run the block.

One structural difference the conversion cannot resolve on its own: in Org, the asterisk at the start of a line defines the hierarchy of the whole document, and that is what the agenda and section folding rely on. If the original Markdown started at heading level two, the resulting Org will carry an empty level at the top — worth reviewing the hierarchy after converting a large file.

Frequently asked questions

Is the code block language preserved?
It is. A Markdown fence declaring a language produces BEGIN_SRC with that language, which is what makes Emacs highlight it and, with Babel, execute it. A fence with no language produces BEGIN_SRC with no argument, which works but does not highlight.
Why does italic become a slash?
That is Org's convention: slash for emphasis, asterisk for bold, underscore for actual underline and tilde for literal code. The difference from Markdown is that Org only recognises those markers when surrounded by whitespace or punctuation, so markup inside a word does not take.
Can I convert back?
Emacs itself exports Org to Markdown with its built-in exporter, and the result is far better than a line-by-line conversion, because it works from the already-parsed document tree. For the return trip, that is the recommended route.

Related Tools