Getting started with HugoBlox: build your first Hugo site
TL;DR
Pick a template, clone the repo, edit your content in Markdown, and deploy to GitHub Pages or Netlify in minutes. No Hugo expertise required.
Key takeaways
- HugoBlox templates ship with sensible defaults — you only configure what you need.
- Content lives in Markdown files, not a database. You own everything.
- A full academic site (about, publications, talks, blog) takes under 30 minutes to set up.
HugoBlox gives you a production-grade Hugo site without having to learn Go templating, Hugo's directory structure, or its partial system. You pick a template, clone a repository, and edit Markdown files. That's the full mental model.
Choose a template
Visit hugoblox.com/templates and find the template that matches your use case. The most popular options:
- Academic CV — publications, talks, courses, and a blog. Used by 100,000+ researchers.
- Landing page — product or personal brand. Converts visitors to subscribers or customers.
- Link in bio — replaces link-aggregator services with a self-hosted page you fully control.
Each template ships with a config/_default/ folder of YAML files. These are the only config files you'll need to touch.
Clone and run locally
git clone https://github.com/HugoBlox/theme-academic-cv my-site
cd my-site
hugo serverOpen http://localhost:1313 and you'll see a live-reloading preview.
Edit your content
Content lives in content/. Each file is Markdown with YAML frontmatter. An about page looks like:
---
title: Alice Researcher
role: PhD Student in Machine Learning
bio: Studying neural scaling laws at XYZ University.
---The template renders this into a structured layout automatically. No HTML or CSS required.
Deploy
GitHub Pages: Push to your main branch. The included GitHub Actions workflow builds and deploys on every push.
Netlify: Connect your repo. Netlify detects Hugo automatically and deploys in ~60 seconds.
Vercel: Same as Netlify — connect the repo, set framework to Hugo, done.
Key takeaways
HugoBlox removes the Hugo learning curve without removing Hugo's speed or flexibility. If you know Markdown and YAML, you have everything you need to ship a professional site today.
Frequently asked questions
Sources
George Cushen
Founder, HugoBlox
George is the creator of HugoBlox and has helped over 150,000 researchers and developers ship beautiful Hugo sites.