Wasabi is a simple and minimal Hexo theme that renders Markdown blog content into static pages with a clean layout and optional Disqus comments.
What is Wasabi?
Wasabi is a simple and minimal Hexo theme, designed for bloggers who want a no-frills presentation for their content. It takes standard Hexo site inputs — Markdown posts, pages, and configuration from _config.yml — and outputs static HTML pages through Hexo's build process. The theme is written with Pug as its template language, so it requires the hexo-renderer-pug package to be installed before Hexo can generate the site. The project is open source under the permissive zlib license and is showcased on the author's personal blog at https://betakuang.me/.
Key Features
- Minimal design — The theme focuses on a clean, uncluttered reading experience for blog posts, with no extra page-building components included.
- Pug templating — Templates are written in Pug, a concise HTML templating engine; you must install
hexo-renderer-pugwith npm for Hexo to compile them. - Disqus integration — Comments are supported by adding a
disqus_shortnamefield to your site's_config.yml; the theme then displays Disqus threads on blog posts. - Hexo compatibility — Installs like any Hexo theme: clone it into the
themesdirectory and settheme: wasabiin_config.yml. - zlib license — The theme is distributed under the zlib license, which allows free use, modification, and redistribution with minimal conditions.
Who is it for?
- Hexo bloggers who want a simple, minimal layout for their posts without managing a complex theme.
- Developers comfortable with Pug who want to customize templates directly, since the theme's structure uses Pug files rather than EJS or other engines.
- Bloggers seeking Disqus comments who need a quick way to add comment functionality through a single configuration key.
What can you do with Wasabi?
- Personal bloggers: Publish Markdown posts via Hexo and get a clean, fast-loading blog with a minimal aesthetic.
- Developers: Use Wasabi as a starting point for a custom Hexo theme by editing its Pug templates and styles.
- Writers: Set up a simple blog focused on text content, with Disqus for reader engagement.
How does Wasabi work?
Set Wasabi as your Hexo theme by copying it into the themes folder and updating _config.yml. Then install the required renderer with npm install hexo-renderer-pug --save. Finally, run your normal Hexo build commands to generate the static site.
