Dominik Honnef

Braindumping org-roam notes

Last modified:

NOTE: This has culminated in the My org-roam workflows for taking notes and writing articles article


We want to publish a subset of our notes. They’re not necessarily worth turning into proper articles, but some people might still stumble upon them and find them useful. Some of our notes are private and we don’t want to publish those. It’d be safest to tag all notes that are public, but since the majority of them are public, that has poor ergonomics. Tagging private notes takes much less work, but risks accidentally leaking a note.

Existing braindumps

We’re not the first to have this idea, of course. We’ve found the following braindumps that are based on org-roam:

Existing workflows

Luckily, they’ve all documented their workflows:

These reveal the following options for turning org-mode files into websites, some of them general, some of them specifically for wikis, knowledge bases and the like.

Our workflow

In the end, we decided to use ox-hugo. org-publish seems too low-level for our needs, and we are already using Hugo elsewhere, which is why we prefer it over one of the other, more special-purpose tools.

To get nice, hyperlinked citations and bibliographies we need to have citeproc installed, and add #+cite_export: csl <path to csl file> to the front matter. Each note also needs an explicit #+print_bibliography: to print the bibliography. All of this isn’t specific to ox-hugo but part of org-mode. We’ve settled for the IEEE style.

TODO backlinks TODO tags + tag pages TODO graph


N. Mather, “How I publish my org-roam wiki with org-publish,” Aug. 21, 2020. (accessed Jan. 06, 2023).
N. Mather, “Options for publishing an org-roam-based digital garden.” (accessed Jan. 06, 2023).
J. Kuan, “Jethro’s braindump,” Jan. 02, 2023. (accessed Jan. 06, 2023).
H. Cisneros, “My org roam notes workflow,” Jun. 15, 2021. (accessed Jan. 06, 2023).
N. Mather, “Using Firn for publishing my org-roam digital garden.” (accessed Jan. 06, 2023).