Gozzi

A Go static site generator born from curiosity.

I built Gozzi to learn how static site generators work. Now I use it for tduyng.com.

Features

• Fast builds with live reload
• Markdown-first content
• Go templates with 40+ helper functions
• RSS, sitemap, Open Graph support
• Server-side KaTeX math & syntax highlighting
• Mermaid diagrams

Quick Start

# Install
go install github.com/tduyng/gozzi@latest

# Create a site
mkdir my-blog && cd my-blog
mkdir -p content/blog templates static

# Configure
cat > config.toml << 'EOF'
base_url = "https://example.com"
title = "My Blog"
EOF

# Create first post
cat > content/blog/hello.md << 'EOF'
+++
title = "Hello World"
date = 2024-01-15
+++

My first post!
EOF

# Serve with live reload
gozzi serve

Visit http://localhost:1313

Documentation

Read the full documentation at tduyng.github.io/gozzi

• Getting Started
• Installation
• Configuration
• Templates
• Content Structure
• CLI Reference
• Template Functions
• Examples

Example

My personal site tduyng.com runs on Gozzi:

• 100+ blog posts and notes
• Server-side KaTeX math rendering (no JS needed)
• Syntax highlighting with Chroma
• Full-text search
• ~100ms builds

View the source →

Development

# Clone and build
git clone https://github.com/tduyng/gozzi.git
cd gozzi
go build -o gozzi .

# Run tests
go test ./...

License

MIT License - see LICENSE for details.