# Hugo — The Fastest Framework for Building Websites

> Hugo is the fastest static site generator in the world, written in Go. Builds thousands of pages in milliseconds with Go templates, Markdown content, shortcodes, and a powerful taxonomy system. Used by 1Password, Kubernetes, Let's Encrypt docs, and many more.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
brew install hugo                           # macOS
snap install hugo                           # Linux
scoop install hugo-extended                 # Windows

hugo new site mysite
cd mysite
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke
echo "theme = 'ananke'" >> hugo.toml
hugo new content posts/hello.md
hugo server -D                              # Dev server at :1313
hugo                                        # Build to public/
```

Content file `content/posts/hello.md`:
```markdown
---
title: "Hello World"
date: 2026-04-12
draft: false
tags: ["intro", "hugo"]
---

This is my first Hugo post.
```

## Intro

Hugo is the fastest static site generator, written in Go by Bjorn Erik Pedersen and Steve Francia. Builds 10,000+ pages in under a second. Uses Go templates for layouts, Markdown for content, and a powerful taxonomy/section system. Trusted by 1Password, Kubernetes, Cloudflare, Linode, and many documentation sites.

- **Repo**: https://github.com/gohugoio/hugo
- **Stars**: 87K+
- **Language**: Go
- **License**: Apache 2.0

## What Hugo Does

- **Blazing fast builds** — 10K pages in <1s
- **Markdown content** — with front matter (YAML/TOML/JSON)
- **Go templates** — layouts, partials, shortcodes
- **Taxonomies** — tags, categories, custom
- **Sections** — content organization by directory
- **i18n** — multi-language support
- **Asset pipeline** — Sass, PostCSS, JS bundling, image processing
- **Data templates** — JSON, CSV, TOML data files
- **Shortcodes** — reusable content snippets
- **Themes** — 400+ community themes

## Architecture

Single Go binary. Reads Markdown + templates from disk, renders HTML to `public/`. No runtime deps, no Node.js, no Ruby. Content model: sections (directories) + taxonomies (tags/categories) + front matter metadata.

## Comparison

| Generator | Language | Speed | Templating |
|---|---|---|---|
| Hugo | Go | Fastest | Go templates |
| Astro | JS | Fast | JSX/MDX |
| Jekyll | Ruby | Slow | Liquid |
| Eleventy | JS | Fast | Multiple |
| Zola | Rust | Very fast | Tera |
| Gatsby | JS | Slow | React |

## FAQ

**Q: Hugo vs Astro?**
A: Hugo is pure static, Go templates, and fastest build speed; Astro supports React/Vue/Svelte components, Islands architecture, is more flexible but requires Node.js. Pick Hugo for pure docs/blogs and Astro for interactive content.

**Q: How to choose a theme?**
A: https://themes.gohugo.io has 400+ themes. Recommended: PaperMod (blog), Docsy (docs), Ananke (starter).

## Sources

- Docs: https://gohugo.io/documentation
- GitHub: https://github.com/gohugoio/hugo
- License: Apache 2.0

---
Source: https://tokrepo.com/en/workflows/hugo-fastest-framework-building-websites-ce6e0794
Author: Script Depot