Hugo Narrow is a modern Hugo theme for building blogs and content sites, built on TailwindCSS 4 and offering multiple color schemes, dark mode, and a rich set of content features.
What is Hugo Narrow?
Hugo Narrow is a Hugo theme developed by tom2almighty and released as open source under the GPL-3.0 license. It takes Hugo Markdown content and produces a static website with a modern, responsive design. The theme is built on TailwindCSS 4 and DaisyUI, and it includes support for multiple color schemes, custom colors, dark mode, a table of contents, search functionality, comment systems, and analytics systems. It also enhances Markdown rendering, code blocks, and offers multilingual support.
Key Features
Hugo Narrow bundles a wide range of features for styling, content, and site administration.
- Multiple Color Schemes — Choose among several built-in color palettes or define your own custom colors to match your brand.
- Dark Mode — Toggle between light and dark themes, either manually or by following the system preference.
- Search Functionality — A built-in search index lets visitors find content across the site without external services.
- Comment Systems — Integrate with popular comment systems so readers can leave feedback on your posts.
- Analytics Systems — Built-in support for analytics tools lets you track site traffic without custom code.
- Enhanced Markdown & Code Blocks — Markdown content gets improved typography, tables, and syntax highlighting for code samples.
- Multilingual Support — Create content in multiple languages with full site translations for a global audience.
- KaTeX & Mermaid — Render LaTeX math equations with KaTeX and create diagrams and flowcharts with Mermaid directly in Markdown.
- Lightbox & Galleries — Display images in a lightbox overlay, and build justified, masonry, or grid galleries using Markdown syntax.
Who is it for?
Hugo Narrow fits several user groups, from individual bloggers to technical writers.
- Bloggers who want a modern, customizable theme with dark mode and multiple color schemes to give their site a distinctive look.
- Developers who prefer TailwindCSS and want a theme they can easily extend or modify using utility classes.
- Technical writers who need to publish mathematical formulas with KaTeX, diagrams with Mermaid, or code snippets with enhanced highlighting.
- Multilingual site owners who need a single theme that supports content in several languages without custom localization work.
What can you do with Hugo Narrow?
With Hugo Narrow you can create a variety of content-rich sites.
- Photographers: Build a portfolio-style blog with masonry or grid galleries using Markdown, and let readers view images in a lightbox.
- Academics and researchers: Write posts that include LaTeX math via KaTeX and flowcharts via Mermaid, all rendered from standard Markdown.
- Open-source maintainers: Create project blogs with searchable documentation, comment integration, and analytics to monitor visitor engagement.
Pricing
Hugo Narrow is free and open source under the GPL-3.0 license. You can use, modify, and distribute it, provided derivative works remain under the same license.
Alternatives
- Hugo Theme Stack
- PaperMod
FAQ
Is Hugo Narrow free?
Yes, Hugo Narrow is open source and released under the GPL-3.0 license. You can use it for personal or commercial projects without paying a fee, as long as you comply with the license terms.
Does Hugo Narrow have dark mode?
Yes, Dark Mode is one of the listed features, allowing visitors to switch between light and dark appearances.
What math and diagram support does Hugo Narrow offer?
Hugo Narrow includes KaTeX support for math equations and Mermaid support for diagrams and flowcharts, both renderable directly from Markdown.
Can I create photo galleries with Hugo Narrow?
Yes, you can create justified, masonry, and grid galleries with Markdown, and images open in a lightbox.





