Skip to content
Go to file


version hexo version npm download license

Demo: 👍 Butterfly || 🤞 JerryC

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/Utterances/Facebook Comments)
  • Multiple Comment System Support
  • Online Chats (Chatra/Tidio/Daovoice/Gitter/Crisp)
  • Web analytics (Baidu Analytics/Google Analytics/Tencent Analytics/CNZZ Analytics)
  • Google AdSense
  • Webmaster Verification (google/Bing/Baidu/360/Yandex)
  • 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
  • Busuanzi visitor counter
  • Medium Zoom/Fancybox
  • Mermaid
  • Justified Gallery
  • Lazyload images
  • Instantpage/Pangu/Snackbar notification toast/PWA......


You can’t perform that action at this time.