Jughead - Blog Theme for Hugo

Jughead is a simple and powerful blog theme for Hugo. It features Giscus comments, Mermaid diagrams, and KaTeX formulae.

More screenshots

Features

• Comments powered by giscus.
• MermaidJS diagrams.
• KaTeX for rendering math formulae.
• Reading time indicators.
• Offline caching with a service worker.
• Two themes: ink (newspaper/OLED) and earth (rust/slate).
• Auto light/dark mode with manual override option.
• i18n support. Translations welcomed!

Installation

Add jughead to your hugo config files in the modules section.

[module]
[[module.imports]]
path = "github.com/ananthb/jughead"

Quickstart

Copy the hugo.toml configuration file from ./exampleSite. Edit parameters as needed.

Themes

Configure your theme in hugo.toml:

[params]
  theme = "ink"        # "ink" or "earth"
  themeMode = "auto"   # "auto", "light", or "dark"

Custom Homepage

By default the homepage shows featured and recent posts. To add custom content above the post listings, create content/_index.md:

---
title: "Home"
---

Welcome to my blog!

Write Posts

Use hugo new posts/my-first-post.md to create a new post. Edit the frontmatter and write your post in markdown. Add a featured category to your post to feature it on the homepage and blog page.

Toggle MermaidJS and KaTeX support in your post frontmatter. Set mermaid to true to enable MermaidJS support, and katex to true to enable KaTeX support.

+++
title = "Diagrams & Equations"
mermaid = true
katex = true
+++

MermaidJS and KaTeX are JavaScript heavy. Enable them when necessary.

License

Fork of archie which is MIT licensed.

This work is dual licensed under the terms of the MIT license for contributions up to January 2026 and under the terms of the GPL 3.0 for later contributions.