HexoHTMLBlogTool Site

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.

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-01View source

What stands out

A quick read of the recorded project description.

01

A Hexo-based blog theme ported from Blackrock Digital's Clean Blog static template

02

Supports Disqus and Facebook comments, with one selectable in the theme configuration

03

Supports post and page cover images, sharing cover images, and homepage cover configuration

04

Built-in methods for creating tag and category pages, enabled by setting the page type to tags or categories

05

Integrates Google Analytics, Addthis sharing, and social account link configuration

06

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.

HexoHTMLBlogTool Site

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. 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. 2

    Menu, homepage cover, default post title, comments, Google Analytics, Addthis, and social links are configured in the theme's _config.yml

  3. 3

    Post author, cover image, sharing cover, and the subtitle used for homepage excerpts must be set in the post front-matter

  4. 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. 5

    Only one of Disqus or Facebook comments needs to be configured, to avoid two comment sets appearing on the same post

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

This theme does not support traditional excerpts. To show excerpts on the index page, use `subtitle` in the front-matter:

Original README
https://github.com/klugjo/hexo-theme-clean-blog/blob/master/LICENSEhttps://github.com/klugjo/hexo-theme-clean-blog/blob/master/README.md

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

![](http://www.codeblocq.com/img/hexo-theme-thumbnail/CleanBlog.png)

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
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.