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
.gmifiles 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.