revised ox-hugo tutorial for errors
[kengrimes.com/content.git] / content / ox-hugo.md
1 ---
2 title: "I did a blog"
3 author: ["Ken Grimes"]
4 date: 2018-04-06T18:29:00-07:00
5 tags: ["blog", "org", "emacs", "hugo"]
6 draft: false
7 heading: "Exporting to Hugo's Blackfriday Markdown from Orgmode"
8 header: "/img/org.png"
9 ---
10
11 ox-hugo is an [Emacs](http://en.wikipedia.org/wiki/Emacs) package for [Org mode](http://en.wikipedia.org/wiki/org-mode) that produces input for the static
12 content generator [Hugo](https://gohugo.io/), which I use for this website. Today I integrated its
13 expectations about file structure into the Speedy theme for this blog, allowing
14 me to keep all blog contents in a single Org mode file and export [markdown](http://en.wikipedia.org/wiki/markdown)
15 content for Hugo's excellent [blackfriday markdown parser](https://github.com/russross/blackfriday) (a markdown format with
16 many added features). Hugo does support limited parsing of org files internally,
17 but Org mode features like inline spreadsheets and system communication are
18 beyond the scope of most external tools, so Org mode is best used as an
19 exporter. As an Emacs user, this allows me to instantly capture interesting
20 information I come across and publish it within seconds. Now I have no excuses!