A Hexo-based blog theme ported from Blackrock Digital's Clean Blog static template
hexo-theme-clean-blog — Hexo Blog Template
By klugjo
hexo-theme-clean-blog is a Hexo blog theme by klugjo that ports Blackrock Digital's Clean Blog static template to Hexo. Under the MIT license, it provides configuration options for cover images, tags and categories, comments, sharing, and code highlighting.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Supports Disqus and Facebook comments, with one selectable in the theme configuration
Supports post and page cover images, sharing cover images, and homepage cover configuration
Built-in methods for creating tag and category pages, enabled by setting the page type to tags or categories
Integrates Google Analytics, Addthis sharing, and social account link configuration
Uses Bootstrap, FeatherLight.js, and jQuery, providing image galleries and code syntax highlighting
Template Details
This is a blog theme for Hexo. The repository describes it as a Hexo implementation of Clean Blog, with the original page from Blackrock Digital's startbootstrap-clean-blog. The theme's menu, homepage cover, default post title, comment service, analytics and sharing IDs, and social links are configured in the theme's _config.yml; post author, cover image, sharing cover, and subtitle are set via front-matter. The repository README gives the installation method: clone the theme into themes/clean-blog, then change theme in the blog's main configuration to clean-blog.
For features, the README lists Disqus and Facebook comments, Google Analytics, Addthis, post and page cover images, tag and category support, responsive images, image galleries, and code syntax highlighting; external dependencies include Bootstrap, FeatherLight.js, and jQuery. The README also states that the theme does not support traditional excerpts, and homepage excerpts must use the subtitle field in front-matter; comments can be disabled per post with comment: false in the post front-matter.
Regarding licensing, the repository contains an MIT license file, permitting free use, modification, commercial use, and distribution of this version of the code, provided the copyright notice and license notice are retained when distributing; third-party assets such as demo images, fonts, and icons must be checked against their respective licenses. The repository was last updated in 2021, and the README does not state production readiness or performance metrics.
Is it right for your project?
Use Cases
- Building a personal blog with Hexo that focuses on post lists and archives
- Blog sites that need cover images, tags, and categories for posts and pages
- Hexo sites that want to provide post comments via Disqus or Facebook
- Writing-focused blogs that need image galleries and code syntax highlighting
- Blogs that display social links such as Twitter, Facebook, GitHub, and LinkedIn in the footer
Suitable For
- Bloggers using Hexo who want to quickly apply the Clean Blog visual style
- Users comfortable configuring via the theme _config.yml and post front-matter
- Developers who need an MIT-licensed theme whose code they can modify and distribute
- Blogs centered on illustrated articles that need cover images and gallery display
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Clone the repository into the Hexo site's themes/clean-blog directory, and set theme to clean-blog in the blog's main _config.yml
- 2
Menu, homepage cover, default post title, comments, Google Analytics, Addthis, and social links are configured in the theme's _config.yml
- 3
Post author, cover image, sharing cover, and the subtitle used for homepage excerpts must be set in the post front-matter
- 4
Tag and category pages must first be created with hexo new page, then set type to tags or categories in front-matter, and added to the menu
- 5
Only one of Disqus or Facebook comments needs to be configured, to avoid two comment sets appearing on the same post
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version of the code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete 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
- The comment feature requires choosing either Disqus or Facebook; if both are filled in, two comment sets will appear on each post, so only one can be selected.
- Using Google Analytics requires providing your own Tracking ID and is an optional configuration that depends on an external third-party service.
- Using the Addthis sharing feature requires providing your own Addthis ID and depends on an external third-party service.
- The theme does not support traditional excerpt functionality; homepage excerpts can only be implemented by using the subtitle field in the post front-matter instead.
- 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
If you specify both a `disqus_shortname` and a `facebook.appid` there will be 2 sets of comment per post. So choose one.
Original README
The Google Analytics Tracking ID is configured in the theme's `_config.yml`.
Original README
The Addthis ID is configured in the theme's `_config.yml`.
Original README
https://github.com/klugjo/hexo-theme-clean-blog/blob/master/LICENSEhttps://github.com/klugjo/hexo-theme-clean-blog/blob/master/README.mdThis theme does not support traditional excerpts. To show excerpts on the index page, use `subtitle` in the front-matter:
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
- More documented · 81 / 100
- Technologies
- Hexo · HTML
- Website type
- Blog · Tool Site
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
- 2021-02-08
- 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: 7c72b9cccc8da33d24ca843b5046ce21a2248e12f6f38a9ad5f0123110309a38
2026-10-01T03:18:20.864Z
Source file / repository# Clean Blog Hexo

Hexo implementation of [Clean Blog](http://blackrockdigital.github.io/startbootstrap-clean-blog/index.html)
Clean blog is a full featured, responsive Hexo theme. [Demo here](http://www.codeblocq.com/assets/projects/hexo-theme-clean-blog/).
## Features
- Disqus and Facebook comments
- Google Analytics
- Addthis
- Cover image for posts and pages
- Tags and Categories Support
- Responsive Images
- Image Gallery
- Code syntax highlighting
## External libraries used
- [Bootstrap](http://getbootstrap.com/css/)
- [FeatherLight.js](http://noelboss.github.io/featherlight/) (Gallery)
- [jQuery](https://jquery.com/)
## Installation
```
$ git clone https://github.com/klugjo/hexo-theme-clean-blog.git themes/clean-blog
```
Then update your blog's main `_config.yml` to set the theme to `clean-blog`:
```
# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: clean-blog
```
## Configuration
### Menu
The menu is configured in the theme's `_config.yml`.
```
# Header
menu:
Home: /
Archives: /archives
Github:
url: https://github.com/klugjo/hexo-theme-clean-blog
icon: github
```
The object key is the label and the value is the path, or you can use a icon (font awesome) like menu item.
### Top Left Label
The top left label is configured in the theme's `_config.yml`. When clicked it will lead to the Home Page.
```
# Title on top left of menu. Leave empty to use main blog title
menu_title: Configurable Title
```
### Home Page cover image
The Home Page cover is configured in the theme's `_config.yml`. It will be the same for all index type pages.
```
# URL of the Home page image
index_cover: /img/home-bg.jpg
```
### Default post title
The default post title (used when no title is specified) is configured in the theme's `_config.yml`.
```
# Default post title
default_post_title: Untitled
```
### Comments
The comments provider is specified in the theme's `_config.yml`. If you specify both a `disqus_shortname` and a `facebook.appid` there will be 2 sets of comment per post. So choose one.
```
# Comments. Choose one by filling up the information
comments:
# Disqus comments
disqus_shortname: klugjotest
# Facebook comments
facebook:
appid: 123456789012345
comment_count: 5
comment_colorscheme: light
```
You can too hide the comment in the posts front-matter:
```
comment: false
---
```
### Google Analytics
The Google Analytics Tracking ID is configured in the theme's `_config.yml`.
```
# Google Analytics Tracking ID
google_analytics:
```
### Addthis
The Addthis ID is configured in the theme's `_config.yml`.
```
# Addthis ID
addthis:
```
### Social Account
Setup the links to your social pages in the theme's `_config.yml`. Links are in the footer.
```
# Social Accounts
twitter_url:
facebook_url:
github_url: https://github.com/klugjo/hexo-theme-clean-blog
linkedin_url:
mailto:
```
### Author
The post's author is specified in the posts front-matter:
```
author: Klug Jo
---
```
### Post's Cover Image
By default, posts will use the home page cover image. You can specify a custom cover in the front-matter:
```
title: Excerpts
date: 2013-12-25 00:23:23
tags: ["Excertps"]
cover: /assets/contact-bg.jpg
---
```
### Post's Share Cover Image
You can specify a custom cover to share yours posts in social medias:
```
share_cover: /assets/contact-bg.jpg
---
```
### Post's Excerpt
This theme does not support traditional excerpts. To show excerpts on the index page, use `subtitle` in the front-matter:
```
title: Excerpts
date: 2013-12-25 00:23:23
tags: ["Excertps"]
subtitle: Standard Excerpts are not supported in Clean Blog but you can use subtitles in the front matter to display text in the index.
---
```
## Tags page.
> Follow these steps to add a `tags` page that contains all the tags in your site.
- Create a page named `tags`
```
$ hexo new page "tags"
```
- Edit the newly created page and set page type to `tags` in the front matter.
```
title: All tags
type: "tags"
```
- Add `tags` to the menu in the theme `_config.yml`:
```
# Header
menu:
Home: /
Archives: /archives
Tags: /tags
```
## Categories page.
> Follow these steps to add a `categories` page that contains all the categories in your site.
- Create a page named `categories`
```
$ hexo new page "categories"
```
- Edit the newly created page and set page type to `categories` in the front matter.
```
title: All categories
type: "categories"
```
- Add `Categories` to the menu in the theme `_config.yml`:
```
# Header
menu:
Home: /
Archives: /archives
Categories: /categories
```
## Creator
This theme was created by [Blackrock Digital](https://github.com/BlackrockDigital) and adapted for Hexo by [Jonathan Klughertz](http://www.codeblocq.com/).
## License
MIT
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
