How to Use mermaid.js with ox-hugo

Introduction This blog is managed with the workflow shown below. graph LR org-mode -- <a href="https://ox-hugo.scripter.co/">ox-hugo</a> --> markdown -- <a href="https://gohugo.io/">Hugo</a> --> HTML When you want to include a diagram like the flowchart above, what methods come to mind? Surely, you’re not thinking about making diagrams in PowerPoint or similar tools, exporting them as images, and… calling it a day? That’s a D-tier move ...

June 21, 2025 · 4 min · Kaoru Babasaki

Fixing Reference Display Issues with ox-hugo

The Problem I was trying to use Org Cite Citations and the following code to display my references: #+print_bibliography: But only the “References” header showed up – the actual list of references was missing. I checked the generated Markdown (.md) files in my content/ directory, and the reference list was there in HTML. However, when I looked at the final HTML files in the public/ directory, the references were gone. This suggested the problem was happening during the Markdown-to-HTML conversion (the md -> html part of org -> md -> html). After some digging, I found an issue on GitHub about the same problem, which led me to the solution. ...

November 12, 2024 · 2 min · Kaoru Babasaki