Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
H

hexo-theme-obsidian

> 编程语言
Open source

A dark Hexo theme, it's responsive, simple but elegant.

787 stars0 likes1 views
WebsiteGitHub

About

A dark Hexo theme, it's responsive, simple but elegant.

Hexo Theme: Obsidian

I am working on a brand new theme called Aurora, therefore this theme currently is not actively maintained. If you are from my blog website, the theme displayed there is the new theme.

View new theme screenshots

More screen shots

Categories Page

Categories Leveled

Archives

Articles

Install

bash
git clone https://github.com/TriDiamond/hexo-theme-obsidian.git obsidian

Usage

Activate Theme

Open Hexo config file _config.yml, set theme to obsidian

yaml
---
theme: obsidian

Installing required packages

First open your terminal, and cd in the theme folder obsidian.

bash
cd themes/obsidian

Then run npm to install all required packages for the theme.

bash
npm install

Theme settings

Open /themes/obsidian/_config.yml can change the theme configs

Full detail config

…

Comments

You can choose from using Valine or Gitalk

  • If you are using Valine, you need to turn off busuanzi,because Valine has article view count support.
  • If you are using Gitalk, you may turn on busuanzi, to have article view count enable.

Code block style

Since version v1.3.5 code block highlight has changed from highlight.js to codemirror, Hexo default highlight need to be disabled to take affect. !! So Please make sure you disabled Hexo's default highlight setting !!

Hexo configuration file _config.yml located at the ROOT path of your blog.

⚠️ Please note do not make these changes in the theme's config file, changing configs in the theme config file _config.yml will not work properly.

yaml
---
highlight:
    enable: false
    line_number: true
    auto_detect: true
    tab_replace:

Codemirror settings

yaml
# Use codemirror instead of highlight js for better color syntax
# if you want more language support check the modes list at official website
# modes see: https://codemirror.net/mode/
# see https://codemirror.net/
codemirror:
    modes: [ 'javascript', 'css', 'xml', 'htmlmixed', 'clike', 'php', 'shell', 'python' ]

Rebuild files after you changed the config

bash
hexo clean && hexo g

Preview character length

This post parameter changes how many characters are kept for the preview at home page.

yaml
title: # My awesome title
date: # 2019-07-14 18:38:45
categories:
#     - Category1 - Category2
tags:
#     - Tag1 - Tag2
mp3: # http://domain.com/awesome.mp3
cover: # http://domain.com/awesome.jpg
preview: # 300

Post template

Post template settings

…

Create categories page

Run Hexo command to generate categories page

bash
hexo new page categories

Categories template

yaml
title: categories
date: 2019-07-14 12:39:04
type: 'categories'

Theme will auto generate categories contents.

Create tags page

Run Hexo command to generate tags page

bash
hexo new page tags

Tags page template

yaml
title: tags
date: 2014-12-22 12:39:04
type: "tags"

Theme will auto generate tags contents.

MathJax Support

Default enables mathjax support, can change it to false to turn it off.

yaml
# Enabling mathjax support
mathjax: true

Update Theme

Please backup your _config.yml file before update

bash
cd themes/osidian
git pull

Using the search engine

Installation guide

Install by npm

bash
$ npm install hexo-generator-search --save

Adding the plugin config in your root _config.yml

yaml
search:
    path: search.xml
    field: post
    content: true

Regenerate files

bash
hexo clean && hexo g

Related

I have made a Typro theme Obsidian especially for this blog theme.

Feedback

Please check the ISSUES before try to use the following contact methods! Maybe the question you have had being asked by others or it's already being answered. Thanks!

You can give me feedback or issue you have through the following methods:

  • Create a issue!
  • Joint QQGroup 909955326
  • Join Telegram Group

Donation

Are you enjoying this project ?

You can express your ❤️ by buying me a coffee ☕️ to keep this project maintained and stay alive, I would ❤️ to ** dedicate more time and effort** on it!

If there are enough coffee ☕️ I would like to become a full time open source developer! Keep producing more awesome themes and applications to the world!

However you could just sharing this project with your friends, that would help me a lot as well!

Thanks for your love in advance! ☀️

Donating using Paypal

All donator will be enlisted as Coffee Supporter and displayed in the Sponsor list in this section.


Wechat 微信支付 Alipay 支付宝支付

所有赞助人将被列为咖啡支持者,并在本节的赞助人名单中显示。

Join the Community

Issues· 76 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

JavaScriptdark-hexo-themedark-modedark-themehexo

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言