blg

a blog generator for people who think the filesystem is a perfectly good CMS

blg turns a directory of markdown files into a blog. Tags are symlinks. The nav bar is a text file. Configuration is an .env file. There is no admin panel, no database, and no YAML frontmatter silently eating your colons.

install

$ curl -fsSL https://blg.capocasa.dev/install.sh | sh

This grabs the latest binary from GitHub releases and drops it in ~/.local/bin (or %LOCALAPPDATA%\Programs\blg). Release binaries update themselves in the background; if that idea offends you, build from source instead and it never will:

$ nimble install blg

use

$ mkdir myblog && cd myblog
$ mkdir md
$ printf '2026-01-01\n\n# Hello\n\nIt works.\n' > md/hello.md
$ blg

Your blog is now in public/. Serve it with anything. Posts are markdown files, the filename is the slug, the first line is the date. Tags are directories full of symlinks:

$ mkdir md/tutorials
$ ln -s ../hello.md md/tutorials/hello.md
$ blg

Run blg -h for the rest; it fits on one screen, which is the point.

features

links