krz/orgo

Lightning fast org-mode static site generator.

clone: git clone https://gitbay.org/krz/orgo.git

82f32f7a429367488954da8f4b1d4e0a6f65f98c

unsigned

author: Christian Cleberg <hello@cleberg.net> · 2026-08-11T22:56:49Z

Record a speed comparison against weblorg

Both generators, one real site, same machine, same moment: 178 org files through
`emacs --script publish.el` and through `orgo build`. Median of three runs each,
and the variance was nil — weblorg landed on 50.03, 50.11, 50.10.

50.1s against 0.21s cold, 0.13s with nothing changed.

The table says what it is measuring, because a benchmark that does not is an
advertisement. weblorg's number includes Emacs starting and loading its packages
— unavoidable per publish, so it belongs in the figure. orgo emits 13 pages
weblorg does not. And the two outputs are not byte-identical.

 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 40cd3b2..bc24c44 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,25 @@ Each of these is a few lines of config, and each has a page in the guide:
 Rebuilds only touch the pages that actually changed, so saving a post on a site with
 hundreds of them stays instant.
 
+## Speed
+
+Publishing one real site — 178 org files, ~180 pages — with the generator it uses today
+and with orgo. Median of three runs each, same machine, same moment:
+
+| | Time | |
+|---|---|---|
+| weblorg (`emacs --script publish.el`) | 50.1s | |
+| orgo, cold build | **0.21s** | 239× faster |
+| orgo, nothing changed since last build | **0.13s** | 385× faster |
+
+Read that with three things in mind. The weblorg figure includes Emacs starting up and
+loading its packages, which you pay on every publish and cannot avoid. orgo emits 13 pages
+weblorg does not (one per tag), so it is doing slightly more work. And the two do not
+produce byte-identical output — the differences are deliberate and listed under
+[Org support](https://krazywarez.github.io/orgo/guide/05-org-support.html).
+
+Apple M2 Pro, 12 cores, macOS 26.6, Emacs 30.2, orgo built with `--release`.
+
 ## The documentation
 
 <https://krazywarez.github.io/orgo/>