For many years, I sought an efficient workflow for managing my personal websites. Over two decades ago, I began with pure HTML, progressed to WordPress, then shifted to my own HTML5 and CSS designs, and eventually adopted Obsidian with Hugo. My primary motivation was to generate websites directly from the source in my chosen editor, but this journey often led to considerable headaches.
Two decades ago, I exclusively used Emacs as my work environment, and at that time, Org mode hadn’t caught my interest. However, upon returning to Emacs, I decided to give Org mode a try. I was pleasantly surprised by its power compared to the standard Markdown and Pandoc setup. After experimenting with it, I’m excited to share the results: my websites are now generated from a single site.org file. The only steps I needed to take were to add the ox-org package to my Emacs configuration and invoke a simple function.
As I’m using Doom Emacs, export itself could be invoked by one straightforward keystroke:
SPC m e H A ;; Doom Leader -> Local mode -> export -> Hugo -> All subtrees to Hugo MD files
The rest is just a pure Hugo configuration.
TL;DR
ox-hugo is an Emacs package that enables users to export Org mode documents to Hugo-compatible Markdown format, facilitating the creation of static sites using the Hugo framework. It allows users to write content in Org mode, a powerful plain text markup language, and then convert it seamlessly into Hugo posts or pages, handling metadata, front matter, and table of contents appropriately. Users can configure various export options, including templates, tags, and categories, providing flexibility for managing how their content appears on Hugo sites. The integration enhances productivity by allowing users to leverage Emacs’ editing capabilities while ensuring compatibility with Hugo’s requirements.
And that’s it!
Have fun! M>
Emacs configuration
(after! org
;; 0) require packages
(require 'ox-hugo))
Log from Message buffer
[ox-hugo] 1/ Exporting 'Home' ..
[ox-hugo] 2/ Exporting 'Profile' ..
[ox-hugo] 3/ Exporting 'Portfolio' ..
[ox-hugo] 4/ Exporting 'Contact' ..
[ox-hugo] 5/ Exporting 'Blog' ..
[ox-hugo] 6/ Exporting '2026-02-13 Websites generation from Org-style document' ..
[ox-hugo] 'New blog post' was not exported as it is tagged with an exclude tag 'noexport'
[ox-hugo] Exported 6 subtrees from sites.org in 0.107s (0.018s avg)
Websites source code example
#+title: Martin Sukany - Architect
#+author: Martin Sukany
#+hugo_base_dir: ../
#+hugo_front_matter_format: toml
* Pages
:PROPERTIES:
:EXPORT_HUGO_SECTION: /
:END:
** Home
:PROPERTIES:
:EXPORT_FILE_NAME: _index
:END:
As a Cloud and Infrastructure Architect with over 20 years of diverse experience in IT including support, engineering, software development, and architecture I specialize in delivering innovative solutions for large financial client. My extensive background equips me to understand complex challenges and implement effective strategies that drive efficiency and growth. Let's transform your infrastructure to meet the demands of today's dynamic landscape.
** Profile
:PROPERTIES:
:EXPORT_FILE_NAME: profile
:END:
TODO: profile
** Portfolio
:PROPERTIES:
:EXPORT_FILE_NAME: portfolio
:END:
Over the past 20 years, I have delivered impactful solutions across diverse technical challenges:
- Founded and developed the BlindUbuntu project, a specialised Linux-based operating system for visually impaired users. In 2006, when accessible open-source solutions were scarce, I conducted comprehensive analysis, selected appropriate assistive tools, and integrated them into a complete out-of-the-box solution.
- Led critical incident response when a disk array failure affected multiple ESX farms, bringing approximately 500 servers offline. I drove the recovery effort and restored full operations, including data redundancy, within 24 hours.
- Developed and deployed a proprietary remediation solution for the Log4j vulnerability affecting over 1,000 servers in my scope, implementing protection before official patches and community tools became available.
- Led a comprehensive monitoring migration project across a multi-platform environment encompassing Unix, Windows, SAN, VMware, appliances, and application monitoring. I designed the target architecture and provided implementation guidance throughout the entire project lifecycle.
- Contributed to enterprise datacentre management software development, employing a data-driven approach to manage thousands of devices for large-scale customers.
- Modernised a monolithic IBM Power application stack, including database, web application, middleware, and interfaces, transforming it into a cloud-native microservices architecture.
After two decades in the industry, I remain passionate about continuous learning and embracing emerging technologies.
** Contact
:PROPERTIES:
:EXPORT_FILE_NAME: contact
:END:
**Martin Sukany**
**Address:** Bri Luzu 114, 68801 Uhersky Brod, ZL Czech Republic
**IC:** 11831073
---
**E-mail:** martin@sukany
;* Blog
:PROPERTIES:
:EXPORT_HUGO_SECTION: blog
:END:
** Blog
:PROPERTIES:
:EXPORT_FILE_NAME: _index
:END:
Here you will find topics that interest me professionally. While not every solution applies to everyone, I enjoy exploring these challenges. These posts represent significant time invested in solving real problems-and solutions worth sharing.
** 2026-02-13 Websites generation from Org-style document :k@it:
:PROPERTIES:
:EXPORT_FILE_NAME: 2026-02-13-emacs-org-hugo-export
:EXPORT_DATE: 2026-02-13
:END:
Here will be text of my first post!