Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


master version master version hexo version license

Demo: Butterfly || CrazyWong

Docs: Butterfly Docs

Based on hexo-theme-melody theme.



If you are in Mainland China, you can download in Gitee

Stable branch [recommend]:

git clone -b master themes/butterfly

Dev branch:

git clone -b dev themes/butterfly


It supports Hexo 5.0.0 or later

In Hexo site root directory

npm i hexo-theme-butterfly


Set theme in the hexo work folder's root config file _config.yml:

theme: butterfly

If you don't have pug & stylus renderer, try this:

npm install hexo-renderer-pug hexo-renderer-stylus


  • Card UI Design
  • Support sub-menu
  • Two Column designs
  • Responsive Web Design
  • Dark Mode
  • Pjax
  • Read Mode
  • Conversion between Traditional and Simplified Chinese
  • TOC catalog is available for both computers and mobile phones
  • Color themes (darker/pale night/light/ocean/mac/mac light), support custom colors
  • Code Blocks (Display code language/close or expand Code Blocks/Copy Button/word wrap)
  • Disable copy/Add a Copyright Notice to the Copied Text
  • Search (Algolia SearchZ/Local Search)
  • Mathjax and Katex
  • Built-in 404 page
  • WordCount
  • Related articles
  • Displays outdated notice for a post
  • Share (AddThis/Sharejs/Addtoany)
  • Comment (Disqus/Disqusjs/Livere/Gitalk/Valine/Waline/Utterances/Facebook Comments/Twikoo/Giscus/Remark42/artalk)
  • Multiple Comment System Support
  • Online Chats (Chatra/Tidio/Daovoice/Gitter/Crisp/messenger)
  • Web analytics
  • Google AdSense
  • Webmaster Verification
  • Change website colour scheme
  • Typewriter Effect: activate_power_mode
  • Background effects (Canvas ribbon/canvas_ribbon_piao/canvas_nest)
  • Mouse click effects (Fireworks/Heart/Text)
  • Preloader/Loading Animation/pace.js
  • Busuanzi visitor counter
  • Medium Zoom/Fancybox
  • Mermaid
  • Justified Gallery
  • Lazyload images
  • Instantpage/Pangu/Snackbar notification toast/PWA......