HugoBlog

clean — Hugo Blog Template

By akccakcctw

Clean is a Hugo blog theme. The repository is MIT-licensed and provides writing-related features such as last modified time for posts, notice blocks, and KaTeX math typesetting.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-11View source

What stands out

A quick read of the recorded project description.

01

A Hugo-based blog theme enabled via the theme field in config.yml

02

Supports setting lastmod in front matter to display a post's last modified time

03

Provides four notice block shortcodes: alert, note, tip, and warning

04

Can enable katex in front matter to dynamically load KaTeX from a CDN for rendering math formulas

05

The repository is MIT-licensed, permitting use, modification, commercial use, and distribution

Template Details

Clean is a blog theme written by Rex Tsou for Hugo. The repository is released under the MIT license and can be used to build a personal blog site. The theme is enabled via the theme field in config.yml, and can be previewed locally with hugo server.

For writing features, the theme supports setting the lastmod parameter in front matter to display a post's last modified time; it provides four notice block shortcodes: alert, note, tip, and warning; and it can optionally load the KaTeX library dynamically from a CDN for math typesetting when katex: true is set in front matter.

The repository materials do not describe the theme's style details, navigation structure, multilingual support, or build artifact requirements, nor do they list extension features beyond the three above, so those aspects should be based on the actual code and demo site.

HugoBlog

Is it right for your project?

Use Cases

  • Building a text-focused personal blog with Hugo
  • Inserting emphasis paragraphs such as notices, cautions, and warnings into articles
  • Writing technical or academic articles that include math formulas
  • Blogs that need to display a post's last modified time

Suitable For

  • Personal bloggers using Hugo as a static site generator
  • Writing scenarios that require notice blocks and math formula typesetting
  • Developers who prefer a simple blog theme and adjust styles themselves

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Clone the repository into the themes directory of a Hugo project

  2. 2

    Set theme: "clean" in config.yml

  3. 3

    Run hugo server to preview the site locally

  4. 4

    When using lastmod, provide the time string in the format date +%FT%T%z

  5. 5

    When using KaTeX, add katex: true to the article's front matter

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version in the public repository under the MIT license; the free scope applies to that version's code, not to external services or third-party assets.

Must comply with when using

  • The code for this version may be used, modified, used commercially, and distributed free of charge.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur separate charges.
  • When using KaTeX math typesetting, the theme dynamically loads the katex library from a CDN, so rendering math formulas depends on external CDN network resources and the feature is unavailable offline or when the CDN cannot be accessed.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

We load katex library from cdn dynamically, add `katex` as parameter in the front-matter if you want to use it.

Original README
https://github.com/akccakcctw/clean/blob/master/LICENSE.mdhttps://github.com/akccakcctw/clean/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-11. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 60 / 100
Technologies
Hugo
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2023-04-18
Screenshot last checked
2026-10-11

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: [email protected] · 2026-10-13

Inspect the recorded source material

SHA-256: c55c590eb885f32e7b8b8ad1641ef9ae9ce471679c56d3c65ed0514428948b6f

2026-10-11T17:44:10.837Z

Source file / repository
# Clean

A clean blog theme for [hugo](https://github.com/gohugoio/hugo).

[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)


![preview](img/preview.png)

## Getting Started

1. Clone this repository to your hugo theme directory.

```sh
$ mkdir themes
$ cd themes
$ git clone https://github.com/akccakcctw/clean.git
```

2. Edit your config.yml:

```yaml
# config.yml
theme: "clean"
```

3. Preview locally with `hugo server`

```sh
$ hugo server
```

Then you can go to https://localhost:1313 and this theme should be visible.


## Features

### Last Modified Date

Add `lastmod` as parameter in the front-matter. You can get the date string by typing `date +%FT%T%z` within command line.

```
---
lastmod: 2022-04-29T10:50:09+0800
---
```

### Notation Block

avaiable notation type:

- alert
- note
- tip
- warning


```
{{<warning>}}
blah blah...
{{</warning>}}
```


### Math Typesetting with `KaTex`

We load katex library from cdn dynamically, add `katex` as parameter in the front-matter if you want to use it.

```
---
katex: true
---
```


## Development

### Commit

```sh
npx git-cz
```


## License

Clean is licensed under the [MIT License](LICENSE.md).


## Author

[Rex Tsou](https://github.com/akccakcctw)
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.