Hexo Theme Tranquility (致远) is a Hexo theme designed for personal homepages and multi-disciplinary bloggers, replacing the default category-based organization with subpages and tags.
What is Hexo Theme Tranquility?
Hexo Theme Tranquility is an open-source Hexo theme that turns a standard Hexo blog into a personal homepage with multiple "subpages" for different fields. It requires Hexo 6.3.0 or newer and Node.js 16 or higher. The theme is developed by hooozen and distributed under the MIT license via GitHub.
What makes Hexo Theme Tranquility stand out?
- Subpage design (子页) — replaces Hexo's default Category with broad field-level subpages, each with its own navigation entry, so a single blog can host multiple disciplines without mixing them.
- Timeline module — displays important milestones, awards, or curated posts via a configurable timeline with color and icon per item, and can be set per-article in the front-matter.
- Resume page — generates an online resume that can be exported to PDF using the browser's print function; content is configured in YAML with title, basic info, education, links, and custom chapters.
- Math formula support — supports LaTeX through either the built-in MathJax loader or the hexo-filter-mathjax plugin for server-side rendering; both require switching to hexo-renderer-pandoc.
- Mermaid integration — enables Mermaid diagrams inside markdown posts via the hexo-filter-mermaid-diagrams plugin and a
mermaidconfig block. - Related posts — uses hexo-related-popular-posts to show relevant articles at the bottom of each post.
- Search — built-in search generates a search.json file with configurable field and content settings.
- Custom fonts — extracts and compresses third-party Chinese fonts into subsets via the zh_font option to balance design and performance.
- Article features — includes cover images, TOC, sticky posts, reward (appreciation) buttons, and an abstract field similar to WeChat official account summaries.
Who should use Hexo Theme Tranquility?
- Multi-disciplinary bloggers — who write across multiple subjects and want each field to have its own clearly separated navigation area.
- Personal homepage owners — who want the homepage to show personal info, a timeline, and an about section rather than a simple article list.
- Developers and professionals — who need a built-in resume page that stays up-to-date through a link and can be printed to PDF.
- Hexo users on older setups — who are comfortable with Node 16+ and can uninstall hexo-generator-category and hexo-generator-archive as required.
What can you do with Hexo Theme Tranquility?
- Build a multi-field blog: create subpages for different disciplines (e.g., technology, life) and assign each post to a subpage via the category field, with tags handling finer classification.
- Showcase milestones: use the timeline to list achievements, projects, or important personal events, each with a custom color and icon.
- Publish a printable resume: configure the CV page with chapters for work experience, projects, or self-evaluation, and export it as a PDF from the browser.
- Write technical posts with diagrams: embed Mermaid charts and LaTeX formulas in markdown, and enable related posts for better user engagement.
How does Hexo Theme Tranquility work?
Installation is a four-step process: clone the theme to themes/tranquility, set theme: tranquility in the blog's _config.yml, uninstall the conflicting hexo-generator-category and hexo-generator-archive packages while installing hexo-pagination, moment, and opentype.js, then copy _config-template.yml to the blog root as _config.tranquility.yml and adjust the options. Upgrades are done with git pull inside the theme directory.
Pricing
Hexo Theme Tranquility is free and open source under the MIT license, with releases published on its GitHub repository.
Alternatives
Other Hexo themes such as NexT, which focuses on a classic blog-reading layout and a different organization model.
FAQ
Is Hexo Theme Tranquility free?
Yes, it is released under the MIT license and the source code is available on GitHub. There are no paid tiers or premium features listed in the repository.
What are the system requirements?
The theme requires Node.js 16 or higher, Git, and Hexo 6.3.0 or newer. It also removes the built-in category and archive generators, so you must install hexo-pagination, moment, and opentype.js after setup.
Does the theme support math formulas?
Yes. You can use LaTeX math by either enabling the built-in mathjax option or using the hexo-filter-mathjax plugin for server-side rendering. Both approaches require replacing the default markdown renderer with hexo-renderer-pandoc and installing the pandoc software.
Can I create a resume page?
Yes. The theme includes a CV module (cv) that builds a resume page from YAML configuration. It supports basic info, education, links, and custom chapters, and can be exported to PDF via the browser's print feature.
