Installation

Requirements

• Go 1.26+ (for building from source)
• Or Docker, or Nix

Docker (Fastest)

docker run -p 8080:8080 -v ./content:/content ghcr.io/larsartmann/dynamic-markdown-site:latest

Open http://localhost:8080.

Build from Source

git clone https://github.com/LarsArtmann/dynamic-markdown-site.git
cd dynamic-markdown-site

# Install Templ CLI
go install github.com/a-h/templ/cmd/templ@latest

# Generate templates
templ generate

# Build the binary
go build -o dynamic-markdown-site ./cmd/dynamic-markdown-site

# Run against a directory of markdown
./dynamic-markdown-site -root ./content

Nix

NIXPKGS_ALLOW_UNFREE=1 nix run github:LarsArtmann/dynamic-markdown-site --impure

Pre-built Binary

Download the latest release from GitHub Releases.

Verify

dynamic-markdown-site -root ./content
# Server starting on :8080

Open http://localhost:8080 to see your markdown files rendered as a website.

Next Steps

• Follow the Quick Start for common usage patterns
• Learn about Configuration for all CLI flags and env vars
• Set up Docker for production deployment
• Connect Cloud Storage (S3, GCS, Azure Blob)