Skip to content


Repository files navigation


master version master version hexo version license

Demo: Butterfly || CrazyWong

Docs: English || Chinese

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 layout
  • Responsive Web Design
  • Dark Mode
  • Pjax
  • Read Mode
  • Conversion between Traditional and Simplified Chinese
  • TOC catalog is available for both computers and mobile phones
  • Built-in Syntax Highlighting Themes (darker/pale night/light/ocean), also support customization
  • 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 Search/Local Search)
  • Mathjax and Katex
  • Built-in 404 page
  • WordCount
  • Related articles
  • Displays outdated notice for a post
  • Share (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/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......