Hugo PaperMod

A fast, clean, and responsive theme for Hugo.

hugo-papermod Minimum Hugo Version Discord GitHub code-size

Based on hugo-paper, with additional features and customization options.

Resource Link
Live Demo adityatelange.github.io/hugo-PaperMod
Documentation Wiki
Example Site Source exampleSite branch

Mockup image


Features

  • Asset pipeline -- Hugo's built-in asset generator with fingerprinting, bundling, and minification.
  • Three layout modes -- Regular, Home-Info, and Profile.
  • Light and dark themes -- Automatic switching based on browser preference, plus a manual toggle.
  • Multilingual support -- Includes a built-in language selector.
  • Search -- Client-side search powered by Fuse.js.
  • SEO optimized -- Open Graph, Twitter Cards, and Schema.org structured data out of the box.
  • Cover images -- Per-post cover images with responsive image support.
  • Table of contents -- Auto-generated from heading structure.
  • Multiple authors -- Native support for multi-author sites.
  • Social icons and share buttons -- Configurable social links and per-post sharing.
  • Breadcrumb navigation
  • Post archives and taxonomies
  • Code block copy buttons -- One-click copying with Chroma syntax highlighting.
  • Related post suggestions
  • Zero JS build dependencies -- No webpack, Node.js, or other tooling required.

For the full list, see the Features wiki page.


Installation

Detailed installation and update instructions are available in the Installation guide.


FAQs and How-To Guides

Common questions and configuration walkthroughs are covered in the FAQ wiki.


Icons

Documentation for social icons and share icons can be found in the Icons wiki.


Changelog

See Releases for a detailed history of changes.


Performance

PaperMod consistently scores near-perfect results on Pagespeed Insights.


Support

  • Star this repository to show your support.
  • Share PaperMod with others who might find it useful.
  • Sponsor the project on GitHub Sponsors or Ko-Fi.

Acknowledgements


Stargazers

Stargazers over time

Languages
HTML 89.3%
CSS 8.7%
JavaScript 2%