← Back to projects

Static Site Generator

A lightweight static site generator written in Go that converts markdown to beautiful HTML pages with zero configuration.

GoMarkdownStatic Sites

Static Site Generator

A zero-config static site generator that converts a directory of markdown files into a fast, beautiful website.

Features

  • Zero configuration — Point it at a folder and it works
  • Fast builds — Generates 1000 pages in under 2 seconds
  • Live reload — Built-in development server with hot reloading
  • Themes — Minimal theming system with CSS custom properties
  • RSS feed — Automatic feed generation from your posts

Design Philosophy

Most static site generators are over-engineered. They require complex configuration files, plugin systems, and deep framework knowledge. This project takes the opposite approach: convention over configuration.

your-site/
├── posts/         # Markdown files become blog posts
├── pages/         # Markdown files become standalone pages
├── static/        # Copied as-is to output
└── theme.css      # Optional custom styles

That’s it. No config files, no plugins, no build steps.

Performance

Written in Go for maximum build performance. Uses goroutines for parallel file processing and an in-memory template cache.

What I Learned

This project reinforced my belief that the best tools are the ones that get out of your way. Every feature request was evaluated against the question: “Does this require configuration?”