ssg - static site generator

A minimal static site generator in Go.

Build

make

Usage

Run from your content directory:

cd site-src
../ssg -o ../docs

Or from anywhere:

ssg -p /path/to/_posts -o /path/to/output \
-url https://example.com \
-title "Example Site" \
-description "Notes and essays"

Options

-o string output directory (required)
-p string posts directory (default "_posts")
-url string public base URL; required for feed.xml
-title string site title used in RSS (default "Site")
-description string site description used in RSS
-language string RSS language (default "en-us")
-draft include draft posts
-d debug output
-v show version
-h show help

Content Structure

site-src/
_posts/ # markdown posts
assets/ # css, js, images
templates/ # html templates
content/ # static pages (about.md)

Post Format

---title: My Posttags: tag1 tag2draft: true # optional---
Summary goes here.
<!--more-->
Full content here.

Date comes from filename: 2026-01-25-my-post.md

Local Preview

cd docs
python3 -m http.server 8000

Dependencies

• goldmark (vendored)

RSS

Each build writes feed.xml at the output root. The feed uses RSS 2.0, contains each post's summary and full rendered HTML, and converts root-relative links and images in full content to absolute URLs. The -url option is required because RSS item links must be absolute.