Exporting from org-mode to markdown

Question

The emacs functions mentioned in the docs don't seem to exist in my org version 7.9.3f.

http://orgmode.org/manual/Markdown-export.html

Any idea how I can get org-mode to export to markdown for me without pulling my hair out?

I have version 8.2.10 of org-mode, installed from melpa, and these two functions are available for me. — Trevoke, Dec 10 '14 at 19:11
yeah I guess I pulled 8.1.x from ELPA and they don't exist... bah — Alex Baranosky, Dec 10 '14 at 19:23
Check this out and take a look inside org-mode? I'm guessing you won't have the `ox-md.el` file but who knows. http://orgmode.org/worg/exporters/ox-overview.html — Trevoke, Dec 10 '14 at 19:28
Is upgrading Org Mode a valid option? Or should this be read as "How can I add Markdown export support to Org 7.9.3f?". — Constantine, Dec 10 '14 at 19:54
Markdown was not appearing for me as an option in the Org Export Dispatcher until I ran `M-x org-md-export-to-markdown`. After that it appeared every time afterwards, including after restarts. — Conor, Mar 30 '15 at 00:07
Put this into your `init.el`: `(require 'ox-md) (add-to-list 'org-export-backends 'markdown) ` — lkahtz, May 30 '22 at 08:21

score 35 · Answer 1 · edited Mar 18 '21 at 16:33

35

You should customize org-export-backends and enable the markdown backend.

M-x customize-option and then org-export-backends and then arrow down to the checkbox to the left of 'md' and press enter to enable it (or just click on it, if running emacs graphically). Then arrow back up and over to 'Apply and Save' (or click on it).

After customizing, run M-x org-md-export-to-markdown. Now you should have a new markdown file in the same directory which is an export of the original org mode file.

edited Mar 18 '21 at 16:33

Vasantha Ganesh

185
10

answered May 02 '16 at 10:51

Uwe Koloska

968
9
13

14

That's: `M-x customize-option` and then `org-export-backends` and then arrow down to the checkbox to the left of 'md' and press enter to enable it (or just click on it, if running emacs graphically). Then arrow back up and over to 'Apply and Save' (or click on it). – Nick Jul 09 '16 at 01:53

score 8 · Answer 2 · answered Dec 13 '14 at 02:03

8

I just ran into this package:

https://github.com/larstvei/ox-gfm

If you want specifically Github-Flavored Markdown, that should help.

answered Dec 13 '14 at 02:03

Trevoke

2,375
21
34

score 7 · Answer 3 · edited Dec 20 '21 at 08:43

7

It can be done using pandoc:

pandoc -s progress.org -o progress.md

or if you have a lot of files to convert:

mkdir md
for f in *.org; do pandoc "$f" -s -o "md/${f%.org}.md"; done

edited Dec 20 '21 at 08:43

Brian Burns

1,577
14
15

answered Jun 04 '18 at 17:47

Chris Stryczynski

707
5
23

2

How about a link to info about pandoc? – Drew Jun 04 '18 at 18:50
1

I didn't feel it's worth the time / effort to find the url and copy and paste the link. But I welcome anyone to edit my answer with this information. – Chris Stryczynski Jun 04 '18 at 18:56

score 4 · Answer 4 · answered Jun 09 '17 at 22:07

The two functions mentioned in the Link you mentioned, as of Org-mode version 8.0, are part of the ox-md.el that has become part of the New Exporter Framework.

For upgrade instructions and more information take a look at the Upgrade Guide and also the announcement of this new framework by its author Nicolas Goaziou.

score 1 · Answer 5 · answered Jun 10 '17 at 00:29

1

Have you tried

(eval-after-load "org"
  '(require 'ox-md nil t))

as discussed in this answer? Once loaded you should see the export option in the normal org export list.

answered Jun 10 '17 at 00:29

mclear

1,525
9
17

The answers indicated he needed to enable the backends. As an aside using ox-gfm, I needed this: (use-package ox-gfm :defer 3 :after org) – RichieHH Jan 13 '20 at 22:36

Exporting from org-mode to markdown

5 Answers5