Writing posts in Org-mode

Sat, 15 Nov 2025 00:00:00 +0000

This whole page is an .org file. Hugo renders Org-mode natively — no plugin, no preprocessor. For text that isn't simple Markdown, Org gives you semantic blocks that Markdown lacks: verse, quote, centred content, source code with arbitrary language, examples, and raw HTML, all without shortcodes.

A common misconception is that Hugo's Org support is "limited". That refers to the Emacs Org-mode ecosystem — agenda, literate programming, mobile sync, the whole catalogue. As a markup format for static web content, Hugo's Org implementation is more featureful than its Markdown implementation. Most theme shortcodes exist to paper over Markdown's gaps.

Markup on demo.theme.tadg.ie

Writing posts in Org-mode