Stigmergic
A fast, beautiful markdown viewer with live reload.
You are looking at it — this site is markdown served by Stigmergic itself.
Stigmergic watches a directory of markdown files and serves them through a local web server. Edit a file and the page updates over Server-Sent Events — no refresh, no build step. Point it at project docs, research notes, AI-generated documentation, or a personal wiki, and you have a live documentation site in seconds.
What You Get
Live Reload
Edit a file, watch the page update instantly. Server-Sent Events push every change; the view refreshes only when the document you are reading changed.
Command Palette
Ctrl+K opens fuzzy search across every file in the corpus. Type a few characters, hit Enter, you are there.
Reader Mode
One keystroke collapses both navigation rails and scales the document up — full-width, distraction-free reading with the header intact.
Keyboard Reading
Leap between sections with n and p. The outline rail tracks your position as you scroll and jumps on click.
Follow Mode
The view follows whatever file changed most recently — watch an agent write documentation in real time.
Math & Diagrams
LaTeX equations via KaTeX, flowcharts and sequence diagrams via Mermaid, wireframes via wiremd. Write fences, see renderings.
Wiki Links & Backlinks
[[target]] links resolve across the corpus, and every document lists the pages that link to it.
Syntax Highlighting
Code blocks in any language, highlighted server-side with theme-matched colors. Toggle any page to its raw markdown source.
Themes
Iceberg Dark and Light ship in the binary; define your own palette in a TOML file. Cycling is one keypress.
Nostr Links
Native rendering of nostr: protocol URIs — npubs, notes, and events become clickable links.
The whole interface is reachable from the keyboard:
- Ctrl+Ksearch
- N / Psections
- Rreader mode
- Ffollow mode
- Ssource view
- Ttheme
- ?all shortcuts
Quick Start
1# Nix
2nix profile install github:Buildtall-Systems/stigmergic.dev
3
4# Go
5go install github.com/Buildtall-Systems/stigmergic.dev/cmd/stigmergic@latest
Pre-built binaries for Linux, macOS, and Windows are on the releases page, checksums included — see installation for all install options and configuration.
1stigmergic serve /path/to/your/markdown
The server starts at http://localhost:8080 and picks the next free port automatically if that one is taken.
Explore This Site
- features — complete feature overview with examples
- installation — install options and setup details
- architecture — how Stigmergic is structured internally
- demo — every supported rendering feature on one page
Built With
Go, HTMX, Templ, Goldmark, Tailwind CSS, KaTeX, Mermaid. No JavaScript frameworks, no database, no build pipeline for your content — markdown files and a single Go binary, version-controlled with git if you want it to be.
Stigmergic is named after the biological phenomenon where organisms coordinate through environmental traces — ants leaving pheromones, termites building mounds. Your markdown files are the traces. Stigmergic makes them visible.