Master Hugo: Build Fast Static Sites with Real‑World Examples

Typical Use Cases

Technical documentation sites

Product manuals

Personal blogs

Team knowledge bases

Company websites

Event landing pages

Core Features

Local Development Preview

After writing content you can preview the site in real time.

hugo server

Multilingual Support

A single content tree can generate multiple language versions. Example directory layout:

content/
├── _index.en.md
├── _index.zh-cn.md
└── posts/
    ├── hello.en.md
    └── hello.zh-cn.md

Content Management

Markdown files can include front‑matter to control draft status, publish date, etc.

---
title: "Article Title"
date: 2023-01-01
draft: true
---

Theme System

Hugo ships with hundreds of open‑source themes; you can also develop your own. Set the theme in config.toml:

theme = "papermod"

Asset Processing

Image compression and processing

CSS/JS bundling and minification

Sass compilation

CDN support

Installation

Windows

Download the Hugo binary package.

Extract it and add the folder to the system PATH.

Verify the installation with hugo version.

macOS

brew install hugo

Linux

sudo apt install hugo

Quick Start

Create a new site: hugo new site myblog Add a theme (example): git submodule add https://github.com/theme.git themes/theme Edit config.toml to set the theme, e.g., theme = "theme".

Create a post: hugo new posts/first.md Preview locally (including drafts): hugo server -D Generate the static site: hugo The generated site consists of static files that can be deployed to any web server or CDN, providing fast load times and low maintenance overhead.

https://github.com/gohugoio/hugo