Hexo Theme Paperwhite is a minimalist theme for the Hexo static site generator that turns Markdown-based content into a simple, fast-loading blog. It is distributed as a Hexo theme package, with configuration handled through a dedicated _config.paperwhite.yml file instead of the global Hexo config.
What is Hexo Theme Paperwhite?
Hexo Theme Paperwhite is a lightweight theme that applies a clean, minimal visual style to any Hexo blog. It takes your existing Hexo site content — posts written in Markdown — and renders it as static HTML pages with a focus on readability. The theme is configured through its own _config.paperwhite.yml file, where you can define navigation menu items and enable the giscus comment system. The repository currently has 18 stars and is tagged with hexo, hexo-blog, hexo-theme, and minimalist.
Key Features
- Minimalist design — A clean layout with minimal decoration, giving priority to text and images in blog posts.
- Menu configuration — Define navigation links in
_config.paperwhite.yml; for example, a "writing" link to/and a "who am I?" link to/about. - Giscus comment integration — Built-in support for giscus; set
enable: trueand provide your repository name in the config to add GitHub Discussions-powered comments to posts. - Dedicated theme config — Instead of editing the main Hexo config, all theme-specific settings live in
_config.paperwhite.yml, keeping your site configuration separate. - Built for Hexo — Works within the Hexo ecosystem, so you can use all standard Hexo commands to create and deploy your site.
Who is it for?
Hexo Theme Paperwhite is for bloggers who already use or want to use Hexo and prefer a minimal, text-focused look. Developers new to Hexo can use it as a simple base theme to understand theme structure. Writers who want to publish without visual distractions will appreciate the clean layout. It also suits developers who want comment functionality via GitHub Discussions rather than a third-party service.
Use cases
- Personal bloggers: create a minimal blog with Hexo and customize the top navigation to match your sections, like "writing" and "about".
- Developers: use it as a starting theme to build a custom Hexo site, adding your own content and menu items.
- Open-source writers: enable giscus to let readers comment using their GitHub accounts through Discussions.
How does it work?
The theme is activated in your Hexo site by setting the theme name in Hexo's _config.yml and placing the theme files in the themes directory. Then edit _config.paperwhite.yml: set your menu items as key-value pairs (for example, writing: /), and if you want comments, enable giscus and add your repository name. After saving, run a Hexo build or deploy command to generate the static site.
FAQ
How do I configure the menu?
Edit _config.paperwhite.yml and add menu items under the menu key. Each line maps a label to a path, e.g. writing: / and who am I?: /about. Save the file and rebuild your site.
How do I enable giscus comments?
Set giscus.enable to true in _config.paperwhite.yml and fill in the repo field with your GitHub repository name in the format owner/repo. Then follow giscus's own setup to connect the repository.
What is giscus?
Giscus is a free comment system powered by GitHub Discussions. It lets visitors leave comments on your blog posts, with comments stored in your GitHub repository. Hexo Theme Paperwhite supports it out of the box through the configuration file.
