Hugo: os comandos que eu realmente uso
Um punhado de comandos que dão conta de 90% do trabalho no dia a dia com o Hugo.
O Hugo tem uma documentação enorme, mas na prática o meu dia a dia se resume a uns poucos comandos. Deixo eles registrados aqui tanto para mim quanto para quem estiver começando agora.
Rodar o site localmente
O servidor de desenvolvimento recarrega a página sozinho a cada arquivo salvo:
hugo server -D
A flag -D inclui os rascunhos (posts com draft: true). Sem ela, você escreve um
texto e fica se perguntando por que ele não aparece.
Criar um post novo
hugo new content posts/2026-08-01-meu-post.md
Eu prefiro colocar a data no nome do arquivo. Não é obrigatório, mas mantém a pasta ordenada cronologicamente quando ela cresce.
Gerar o site para publicação
hugo --gc --minify
O resultado sai na pasta public/. O --gc limpa o cache de imagens que não são mais
usadas e o --minify comprime o HTML e o CSS.
Uma armadilha comum
Se um post não aparece na listagem, quase sempre é uma destas três causas:
| Causa | Como resolver |
|---|---|
draft: true no cabeçalho | Remova ou rode com -D |
| Data no futuro | Ajuste a data ou use --buildFuture |
Arquivo fora de content/posts/ | Mova para a pasta certa |
Levei um tempo até decorar essa lista. Agora ela mora aqui.