Using ox-Hugo

Sat, 17 Jan 2026 00:00:00 -0500

Hugo is a static website generator written with GO, providing easily capability to convert markdown files into a website. For those who use emacs Org mode , one can use ox-hugo to convert Org files into markdown files that will be compatible with Hugo. Hence the workflow is:

\[\mathrm{Org} \\ \xrightarrow{\text{ox-hugo}} \\ \mathrm{markdown} \\ \xrightarrow{\text{Hugo}} \\ \mathrm{HTML}\]

For me, I use it to create my research journal and personal website.

Here I describe different ways of writing things in Org mode that can be re-interpreted by ox-hugo to generate the corresponding md files that can be used by Hugo for my own records.

Ox-Hugo on zhi

Using ox-Hugo