README

Hugo PaperMod

A fast, clean, and responsive theme for Hugo.





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


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




  


---

 Features 💥

☄️ Fast | ☁️ Fluent | 🌙 Smooth | 📱 Responsive

- 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.

| Topic                                                                                             | Description                                     |
| ------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| Installation guide        | Detailed installation and update instructions   |
| Features wiki page            | In-depth explanations of all features           |
| FAQ wiki                          | Common questions and configuration walkthroughs |
| Icons wiki                       | Documentation for social icons and share icons  |
| Variables wiki               | List of all available template variables        |
| Overiding templates | Guide to customizing templates without forking  |
| Releases                           | Detailed history of releases                    |

---

 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.

---

 Special Thanks 🌟

- Highlight.js
- Fuse.js
- Feather Icons
- Simple Icons
- All contributors and supporters

Top issues

Discussions

Latest release

Release 8.0 Changelog

Huge thanks to contributors for making this theme better :)
Also a Big Thank You to supporters at Ko-Fi and Github Sponsors. Kudos to you guys :heart_decoration:


 What's Changed
 change \ element CSS styling to use line-through by @dubbl in https://github.com/adityatelange/hugo-PaperMod/pull/1181
 Add condition to disable edit post on md file by @douglastofoli in https://github.com/adityatelange/hugo-PaperMod/pull/1143
 Allow loading cover from /assets folder by @timonback in https://github.com/adityatelange/hugo-PaperMod/pull/1187
 Updating pagination string