hexo-theme-reimu is a free, open-source Hexo blog theme styled after the Touhou Project character Hakurei Reimu, created by D-Sketon.
What is hexo-theme-reimu?
hexo-theme-reimu is a Hexo theme (compatible with Hexo 6 and above) that transforms Markdown blog posts and front matter into a static blog with a distinctive Reimu-inspired visual design. It draws from three existing themes — landscape, Tangyuxian, and Shoka — and is distributed both as an npm package (hexo-theme-reimu) and as a GitHub repository. The project also maintains feature-aligned ports for Hugo (hugo-theme-reimu) and Astro (astro-theme-reimu), so the same visual style and much of the configuration can be reused across static site generators.
Key Features
- Framework and styling — Built for Hexo 6+ with Stylus-based styling, responsive layout, and support for light, dark, and system-auto color modes.
- Math and diagrams — KaTeX (server- or client-side) and MathJax3 support, plus Mermaid flowcharts, each enabled through configuration and per-post front matter.
- Comment systems — Integrates Valine, Waline, Twikoo, Gitalk, Giscus, Disqus, Utterances, and Beaudar, with the ability to run multiple systems simultaneously since v1.7.0.
- Search — Bundles
hexo-generator-searchfor local search and supports Algolia search through@reimujs/hexo-algoliasearch; the two modes should not be enabled at the same time. - Media and interaction — APlayer with optional Meting music playback, image lazy loading, Pace progress bar, mouse-firework effects, custom Reimu mouse cursors, and Live2D or Live2D-widgets integration.
- Built-in tag plugins — Link cards (
link), friend cards (friendLink), tabs, gallery, grid, alertBlockquote, details, heatMapCard, tagRoulette, and custom VitePress-like containers. - Customization — Configurable CDN sources, Google/local/custom fonts, CSS variable token theming, dynamic Material You theme colors from the banner image, and custom injector hooks for head, body, and sidebar.
- Performance and SEO — PJAX, Service Worker, Quicklink prefetch, responsive banner images (
srcset), article copyright cards, share links/cards, and RSS feed support.
Who is it for?
- Touhou fans and personal bloggers who want a Reimu-styled blog that stands out visually with custom cursors, live2d sprites, and a themed preloader.
- Hexo users who want a feature-dense theme without assembling many plugins: search, comments, math, diagrams, analytics, and music come built in or are documented.
- Multi-site maintainers who manage blogs on both Hexo and Hugo or Astro and want the same Reimu look across all of them.
- Quick starters — the reimu-template repository preinstalls Hexo, this theme, and its companion packages, so cloning and editing config produces a working blog.
What can you do with hexo-theme-reimu?
- Academic and technical writers: render LaTeX-style math with KaTeX or MathJax3 and embed Mermaid flowcharts; code blocks include one-click copy and optional copyright notices.
- Bilingual and regional content creators: choose among five built-in languages (en, zh-CN, zh-TW, ja, pt-BR) and enable the experimental
i18ngenerator for per-page multi-language paths. - Community bloggers: run dozens of comment integrations and use share cards for Facebook, Twitter, Bluesky, LinkedIn, Reddit, Weibo, QQ, and WeChat to spread posts.
- Performance-conscious bloggers: turn on PJAX, Service Worker, Quicklink, and responsive banner srcsets to speed up navigation and mobile loading.
How does hexo-theme-reimu work?
Install the theme with npm install hexo-theme-reimu --save (or clone the repo into the themes folder), set theme: reimu in the Hexo _config.yml, and create the source/_data, source/about, and source/friend directories referenced in the documentation. Then configure the theme's inner _config.yml to enable features and run hexo g to build the static site. For a zero-setup start, the reimu-template repo comes with Hexo, the theme, and required packages preinstalled.
FAQ
Is hexo-theme-reimu free?
Yes, hexo-theme-reimu is released under the MIT license, and it is available for free on both npm and GitHub. Some optional services (Algolia, LeanCloud, comment platforms) require their own accounts or hosting.
Does hexo-theme-reimu support dark mode?
Yes. The theme provides a dark mode toggle, and the dark_mode config accepts true (default dark), false (default light), or auto (follows the user's system setting).
Which comment systems can I use with hexo-theme-reimu?
The theme supports Valine, Waline, Twikoo, Gitalk, Giscus, Disqus, Utterances, and Beaudar. Since v1.7.0 you can enable multiple comment systems at once and set a default via the comment.default option.
What do I need to enable math formulas?
Install @reimujs/hexo-renderer-markdown-it-plus (after uninstalling hexo-renderer-marked), set math.enable to true, and then choose either KaTeX or MathJax3 — enabling both simultaneously is not supported.
Is there a Hugo or Astro version?
Yes. D-Sketon maintains hugo-theme-reimu and astro-theme-reimu ports, so you can get the Reimu design on those static site generators as well.
