Modified from the Hexo Clean Blog theme, retaining the original blog layout
HexoBlog
hexo-theme-clean — Hexo Blog Template
By luswdev
hexo-theme-clean is a Hexo blog theme modified from the Hexo Clean Blog theme by luswdev, released under the MIT license, adding features such as a table of contents, math formulas, a lightbox, comments, and analytics.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
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-01View source
What stands out
A quick read of the recorded project description.
Supports cover images for posts and pages, a table of contents, and code syntax highlighting
Integrates MathJax math formulas and Bootstrap Alert, Card, and Label components
Supports a Light Gallery lightbox, with responsive display for images, tables, and code blocks
Can integrate Disqus and Gitalk comments, as well as Google Analytics, Busuanzi statistics, and word count
Supports tags, categories, an about page, pinned posts on the homepage, and Hexo local search
Template Details
hexo-theme-clean is a blog theme for Hexo, modified by its author from the Hexo Clean Blog theme in both features and code style. The README indicates that its features cover cover images for posts and pages, a table of contents, code syntax highlighting, MathJax math formulas, Bootstrap Alert/Card/Label components, responsive images and tables, a Light Gallery lightbox, Disqus and Gitalk comments, Google Analytics, Busuanzi statistics and word count, as well as tags, categories, an about page, and pinned posts on the homepage, and it supports Hexo local search.
Installation involves cloning the repository into the themes/clean directory of a Hexo blog, then setting theme to clean in the site's main _config.yml. The theme provides an online demo and a link to full documentation, which is located on the author's blog at the theme-clean-doc page.
Regarding usage limitations, the theme is built on Hexo and must be used with a Hexo site; features such as comments, analytics, and search depend on the corresponding third-party services or plugin configurations. The licenses for third-party assets such as demo images, fonts, and icons must be checked separately and cannot be judged solely by the code's MIT license.
HexoBlog
Is it right for your project?
Use Cases
- Building a personal blog with Hexo and wanting to change the theme
- Writing scenarios that require displaying math formulas or code highlighting in posts
- Wanting to add comments, visit analytics, and local search to a blog
- Needing basic content organization methods such as tags, categories, and an about page
Suitable For
- Sites using the Hexo static blog framework
- Writers who prefer a clean blog layout and need a table of contents
- Blogs that need to display technical content such as math formulas, a lightbox, and code highlighting
- Users who want to freely modify and distribute the theme code under the MIT license
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Clone the repository into themes/clean under the Hexo blog directory
- 2
Set theme to clean in the site's main _config.yml
- 3
Features such as comments, analytics, and search require configuring the corresponding third-party services or plugins according to the documentation
- 4
Full usage instructions for the theme are on the author's blog at the theme-clean-doc documentation page
- 5
Licenses for third-party assets such as demo images, fonts, and icons must be checked separately
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- Permits free use, modification, commercial use, and distribution of this version's code.
- 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
- This theme is modified from the Hexo Clean Blog theme and is a Hexo blog theme; it must be used with the Hexo static site framework and cannot run as a standalone general-purpose website template outside Hexo.
- Comment and analytics features depend on third-party services: Disqus and Gitalk comments, as well as Google Analytics and Busuanzi statistics, all require registering accounts and configuring the corresponding services or plugins before they take effect.
- The full usage documentation is hosted on the author's personal blog page rather than in the repository, so users must visit an external site to consult configuration instructions before use.
- 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 additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
This is a theme base on <a href="https://github.com/klugjo/hexo-theme-clean-blog">Hexo Clean Blog Theme</a>, and modfiy for more feature and coding style.
Original README
- Disqus and Gitalk - Google Analytics, Busuanzi Statistics and Word counts support
Original README
https://github.com/luswdev/hexo-theme-clean/blob/master/LICENSEhttps://github.com/luswdev/hexo-theme-clean/blob/master/README.mdYou can learn how to use this theme by view full document [here](https://blog.lusw.dev/posts/hexo/theme-clean-doc.html).
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-01. 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 · 72 / 100
- Technologies
- Hexo
- 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-08-26
- Screenshot last checked
- 2026-10-01
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 Hexo 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.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 5ac0b6a209d1888f9c486a747df7c2d1cf840414c6305ac453f015765db0c21f
2026-10-01T03:30:59.150Z
Source file / repository# <div align="center">Hexo Theme Clean</div>
<p align="center">
<a href="https://github.com/luswdev/hexo-theme-clean/blob/master/LICENSE"><img alt="GitHub" src="https://img.shields.io/github/license/luswdev/hexo-theme-clean?style=for-the-badge"></a>
<a href="https://github.com/luswdev/hexo-theme-clean/releases/"><img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/luswdev/hexo-theme-clean?style=for-the-badge"></a>
<a href="https://hexo.io/" rel="nofollow"><img alt="Hexo" src="https://img.shields.io/badge/Hexo->=4.0.0-blue?style=for-the-badge&logo=hexo"></a>
<a href="https://github.com/luswdev/hexo-theme-clean/releases/"><img alt="GitHub All Releases" src="https://img.shields.io/github/downloads/luswdev/hexo-theme-clean/total?style=for-the-badge"></a>
</p>
<p align="center">
This is a theme base on <a href="https://github.com/klugjo/hexo-theme-clean-blog">Hexo Clean Blog Theme</a>, and modfiy for more feature and coding style.
</p>
## Live Demo
<p align="center">
➡️ <a href="https://blog.lusw.dev">Demo</a>
</p>
## Features
- Cover image for posts and pages
- Post toc
- Code syntax highlighting
- MathJax support
- Bootstrap Alert, Card and Label support
- Responsive Images, table and codeblock
- Light Gallery support
- Disqus and Gitalk
- Google Analytics, Busuanzi Statistics and Word counts support
- Tags, Categories and About support
- Pin post at home page support
- Hexo local search
## Installation
- Clone into your hexo blog directory
```
$ git clone https://github.com/luswdev/hexo-theme-clean.git themes/clean
```
Then update your blog's main `_config.yml` to set the theme to `clean`:
```
# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: clean
```
## Document
You can learn how to use this theme by view full document [here](https://blog.lusw.dev/posts/hexo/theme-clean-doc.html).
## Creator
This theme was created by [Blackrock Digital](https://github.com/BlackrockDigital), adapted for Hexo by [Jonathan Klughertz](http://www.codeblocq.com/) and modfy by [LuSkywalker](https://lusw.dev/)
## Version
- V1.1.0
- Fixed subdir bugs.
- Fixed footnote id bugs.
- Add Google Fonts for TC.
- V1.0.0
- Base fuction support.
Explore similar templates
Compare previews and descriptions within the same stack and category.
hexo-theme-matery
hexo-theme-matery is a Material Design, responsive Hexo blog theme with homepage carousel, waterfall post list, timeline archive, word cloud tags, radar chart categories, and an about page.
Hexo · Blog
hexo-theme-cactus
Cactus is a responsive Hexo theme for personal websites and blogs, maintained by probberechts. It offers four color schemes (dark, light, white, classic), configurable navigation, homepage post lists, project lists, social links, and copyright year ranges.
Hexo · Blog
hexo-theme-volantis
Volantis is a blog theme for Hexo, distributed as the npm package hexo-theme-volantis and enabled by setting theme to volantis in the Hexo site's _config.yml. It requires Hexo 7.3+, hexo-cli 4.3+, Node.js 22.x LTS+, and npm 10.x LTS+.
Hexo · Blog
hexo-theme-aurora
Hexo Theme Aurora is a futuristic Hexo blog theme built around aurora gradients and a magazine-style grid layout.
Hexo · Blog
hexo-theme-Claudia
Claudia is a Hexo blog theme focused on a clean look and easy configuration. It automatically follows the device's dark mode and claims a 90+ Lighthouse score.
Hexo · Blog
hexo-theme-A4
hexo-theme-A4 is a minimalist Hexo blog theme that mimics the texture of A4 paper, emphasizing simplicity, small size, and minimal configuration.
Hexo · Blog