← weblog / 2026-06-30

Moving my weblog off Gemini (without leaving it)

- -

This is placeholder text laid out so you can see how a full post reads. Replace it with the real .gmi content when you export the capsule — the structure below covers everything a converted Gemini post will need: headings, lists, quotes, code, and links.

- -

I've kept a capsule at gemini://gemini.ctrl-c.club/~tjp/ for a few years now. Gemini is a lovely place to write: the format is so constrained that there's nothing to fiddle with, and the whole thing rewards plain, linear prose. But I wanted a web presence too — one that fits in with the personal sites I keep finding in webrings.

- -

The plan

The goal was never to abandon geminispace. It was to have both, from one source of truth. Gemtext is close enough to Markdown that a small converter gets you most of the way there:

- -

Keep writing .gmi files in my capsule.
Run a converter that emits HTML with the same structure.
Wrap each page in the site template you're reading now.

- -

The converter

Gemtext has exactly one block-level construct per line, which makes parsing almost insultingly simple. Here's the core of it:

- -

while IFS= read -r line; do
-  case "$line" in
-    "### "*) echo "<h3>${line#### }</h3>" ;;
-    "## "*)  echo "<h2>${line### }</h2>" ;;
-    "# "*)   echo "<h1>${line## }</h1>" ;;
-    "=> "*)  emit_link "$line" ;;
-    "* "*)   emit_list_item "$line" ;;
-    "> "*)   echo "<blockquote>${line#> }</blockquote>" ;;
-    "")      echo "" ;;
-    *)       echo "<p>$line</p>" ;;
-  esac
-done < "$1"

- -

That's genuinely most of it. The fiddly parts are link lines (=> can be a bare URL or have link text) and collapsing runs of * lines into a single <ul>.

- -

The best format is the one that outlives the tool you wrote it in. Gemtext will still be readable when this converter is long gone.

- -

What I kept

No client-side anything. The web version renders identically with JavaScript disabled, because there is no JavaScript to disable. Fonts are whatever your system already has. The whole page is a few kilobytes.

- -

If you want the source, it lives with the rest of my projects. And the capsule is still there — see the colophon for how it all fits together.