A minimal, responsive Jekyll theme for technical blogs, with dark mode, syntax highlighting, math, Mermaid diagrams and PWA support.
adityatelange/hugo-PaperMod
A fast, clean, responsive theme for the Hugo static site generator, aimed at blogs and portfolios.
- Stars
- 14,028
- Forks
- 3,430
- Open issues
- 10
- Last commit
- 13 days ago
What is it?
PaperMod is a theme for Hugo, the static site generator. It provides ready-made layouts for blogs, portfolios and personal sites, including a regular post list, a home page with info section, and a profile mode.
The theme covers common site needs out of the box: client-side search powered by Fuse.js, light and dark modes with a manual toggle, table of contents generated from headings, cover images, related posts, and multilingual support with a language selector. It also outputs Open Graph, Twitter Card and Schema.org metadata for SEO.
PaperMod uses Hugo's built-in asset pipeline for fingerprinting, bundling and minification, so it needs no Node.js or webpack build step. Installation and template customization are documented on the project wiki.
Key features
- 01Built-in asset pipeline with fingerprinting, bundling and minification
- 02Regular, Home-Info and Profile layout modes
- 03Light and dark themes with automatic and manual switching
- 04Client-side search via Fuse.js
- 05SEO metadata including Open Graph, Twitter Cards and Schema.org
Use cases
- Setting up a personal blog on Hugo with a clean, readable design
- Building a developer or designer portfolio site with a profile layout
- Running a multilingual static website with a language switcher
Quick start
- 1
Read the installation guide in the project wiki
Things to know
- Requires Hugo v0.158.0 or newer.
In collections
Topics
FAQ
- What is hugo-PaperMod?
- A fast, clean, responsive theme for the Hugo static site generator, aimed at blogs and portfolios. PaperMod is a theme for Hugo, the static site generator. It provides ready-made layouts for blogs, portfolios and personal sites, including a regular post list, a home page with info section, and a profile mode.
- Is hugo-PaperMod free to use? What license does it have?
- hugo-PaperMod is open source under the MIT license. Check the license terms before using it in commercial products.
- Is hugo-PaperMod still maintained?
- Actively maintained. The last commit to hugo-PaperMod was on Oct 25, 2026.
- What can I use hugo-PaperMod for?
- Setting up a personal blog on Hugo with a clean, readable design Building a developer or designer portfolio site with a profile layout Running a multilingual static website with a language switcher
- How do I install hugo-PaperMod?
- Read the installation guide in the project wiki
- Where can I get hugo-PaperMod?
- The source code and installation instructions are on GitHub: https://github.com/adityatelange/hugo-PaperMod
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A simple, mobile-friendly documentation theme for the Hugo static site generator, styled after a plain book.
A Hugo theme for building technical documentation websites, maintained under the Linux Foundation.
A high-end, responsive WordPress theme with light and dark modes, no-refresh page loading, and built-in third-party login.
An online manager for static blog frameworks like Hexo, Hugo and Valaxy, for editing posts, images and site settings from the browser.
A free, open-source Astro and Tailwind CSS v4 starter theme with 30+ landing page widgets, a blog, and SEO features.