HugoBlog

Calmato — Hugo Blog Template

By zdong1995

Calmato is a Hugo-based blog theme maintained by zdong1995, derived from the LoveIt and KeepIt themes, and licensed under MIT.

Open Source SiteDownload Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

Hugo-based blog theme derived from LoveIt and KeepIt, licensed under MIT

02

Extended Markdown syntax supports Font Awesome icons, ruby annotations, and fractions

03

Built-in shortcodes for KaTeX formulas, mermaid diagrams, ECharts visualizations, and Mapbox maps

04

Supports APlayer/MetingJS music player and Bilibili video player shortcodes

05

Search can use Lunr.js or Algolia; comment systems support Disqus, Gitalk, Valine, Utterances, and more

06

Supports multilingual and i18n; since v1.1.0, multi-level menus and sub-column pages are included

Template Details

Calmato is a blog theme for Hugo, with the repository maintained by zdong1995 and licensed under MIT. The README states that it is modified from the LoveIt Theme and KeepIt Theme. Key differences include a custom header and CSS styles, a rewritten homepage for compatibility with newer Hugo versions, adjustments to color schemes and font sizes, improved dark mode readability, and the addition of CSS animations, an auto-expanding table of contents, more social links and sharing sites, multiple comment systems, and search based on Lunr.js or Algolia.

The theme provides extra content capabilities through extended Markdown syntax and shortcodes: Font Awesome icons, ruby annotations, fractions, KaTeX math formulas, mermaid diagrams, ECharts data visualizations, Mapbox maps, APlayer and MetingJS music players, Bilibili player, admonitions, custom styles and scripts, as well as TypeIt typing animations, smooth scrolling, and a cookie consent banner. Since v1.1.0, multi-level menus and sub-column pages are supported.

The theme supports multilingual and i18n. Languages listed in the README include English, Simplified Chinese, French, Polish, Brazilian Portuguese, Italian, Spanish, German, Serbian, Russian, Romanian, and Vietnamese. Comment systems can be Disqus, Gitalk, Valine, Facebook, Telegram, Commento, or Utterances; analytics supports Google Analytics and Fathom; avatars support Gravatar or local images.

Note that the README's description of PageSpeed scores is the author's own statement and has not been independently verified in this material; the licenses of third-party libraries, fonts, icons, and demo images need to be checked separately, as the MIT license covers only the theme code itself. The repository was last updated in January 2021, and compatibility with the current Hugo version should be confirmed before use.

HugoBlog

Is it right for your project?

Use Cases

  • Building an article-focused personal tech blog or writing site
  • Blogs that need to embed math formulas, flowcharts, or data charts in articles
  • Sites that want to switch between multiple comment systems and search options within the same theme
  • Blogs for multilingual readers that need i18n and multilingual content support
  • Content-oriented blogs that need to embed a music player or Bilibili videos in articles

Suitable For

  • Developers and writers using Hugo to build static blogs
  • Content creators who need extended Markdown syntax and shortcodes
  • Bloggers who prefer light/dark dual modes and responsive layouts
  • Site maintainers who need multilingual sites and multi-level menu structures

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    The theme requires a Hugo environment; the example command in the README is hugo server --source=exampleSite

  2. 2

    Features such as search, comments, and analytics depend on third-party services and require applying for and configuring the corresponding parameters

  3. 3

    Third-party assets such as demo images, fonts, and icons need to be checked under their respective licenses; MIT covers only the theme code

  4. 4

    The repository was last updated in January 2021; compatibility with the current Hugo version should be confirmed before use

  5. 5

    Descriptions such as performance scores in the README are the author's own statements and have not been independently verified in this material

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version in the public repository under the MIT license; the free scope is the code of that version and does not mean external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party assets need to be checked under their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
  • Search functionality depends on third-party services: Lunr.js or Algolia can be chosen; using Algolia requires registering an account and configuring API keys.
  • Site analytics depends on the external Google Analytics service, requiring registering an account and configuring tracking parameters.
  • Site analytics can optionally use Fathom Analytics, an external paid service that requires registration and bearing the corresponding costs.
  • The Mapbox map shortcode depends on the external Mapbox GL JS service and typically requires a Mapbox account and access token.
  • Comment systems depend on third-party services; for example, Disqus requires registering an account and embedding its script, with data hosted on an external platform.
  • Gitalk comments depend on a GitHub OAuth application, requiring creating and configuring a client ID and secret.
  • Valine comments depend on backend services such as LeanCloud, requiring registering an account and providing an App ID and Key.
  • Telegram comments depend on the external comments.app service, requiring registration and configuring the corresponding site parameters.
  • The Commento comment system is an external service that requires self-deployment or using its hosted service and configuration.
  • Utterances comments depend on GitHub Issues and GitHub App authorization, requiring configuring a repository and authorization.
  • Third-party libraries can be loaded via CDN; actual availability and costs depend on the chosen CDN provider.
  • The README provides a sponsorship entry (PayPal), which is voluntary donation and does not affect free use of the theme.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

**Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/)

Original README

**[Google Analytics](https://analytics.google.com/analytics)** supported

Original README

**[Fathom Analytics](https://usefathom.com/)** supported

Original README

**Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)

Original README

**Disqus** comment system supported by [Disqus](https://disqus.com)

Original README

**Gitalk** comment system supported by [Gitalk](https://github.com/gitalk/gitalk)

Original README

**Valine** comment system supported by [Valine](https://valine.js.org/)

Original README

**Telegram comments** system supported by [Telegram Comments](https://comments.app/)

Original README

**Commento** comment system supported by [Commento](https://commento.io/)

Original README

**Utterances** comment system supported by [Utterances](https://utteranc.es/)

Original README

**CDN** for all third-party libraries supported

Original README

If you enjoy the theme, please consider buying me a coffee ☕️.

Original README
https://github.com/zdong1995/Calmato/blob/master/LICENSEhttps://github.com/zdong1995/Calmato/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-04. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 68 / 100
Technologies
Hugo
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2021-01-11
Screenshot last checked
2026-10-04

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: codex-user-requested-batch-review-20261017 · 2026-10-16

Inspect the recorded source material

SHA-256: 9d7d6fbab4e264c5e7958bd2fe5fc8844308322d33a945060bed771b336aec56

2026-10-04T18:25:30.089Z

Source file / repository
# Calmato Theme | Hugo [![Netlify Status](https://api.netlify.com/api/v1/badges/bea56ccf-e63f-44db-b4be-6ea0bfc86c00/deploy-status)](https://app.netlify.com/sites/calmato/deploys)

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/zdong1995/calmato?style=flat-square)](https://github.com/zdong1995/calmato/releases)
[![Hugo](https://img.shields.io/badge/Hugo-%5E0.62.0-ff4088?style=flat-square&logo=hugo)](https://gohugo.io/)
[![License](https://img.shields.io/github/license/zdong1995/calmato?style=flat-square)](https://github.com/zdong1995/calmato/blob/master/LICENSE)

English README | [简体中文说明](https://github.com/zdong1995/calmato/blob/master/README.zh-cn.md)

> **Calmato** is a **clean**, **elegant** but **advanced** blog theme for [Hugo](https://gohugo.io/).

It is based on the original [LoveIt Theme](https://github.com/dillonzq/LoveIt) and [KeepIt Theme](https://github.com/Fastbyte01/KeepIt).

Since the three themes have a similar look, if you have questions about their differences,
read [Why choose calmato](#why-choose-calmato) so that you can choose the one that works best for you.

![Hugo Theme calmato](https://github.com/zdong1995/calmato/raw/master/images/Apple-Devices-Preview.png)

## [Demo Site](https://calmato.netlify.app)

To see this theme in action, here is a live [demo site](https://calmato.netlify.app) which is rendered with **calmato** theme.

## Why choose calmato

Compared to the original LeaveIt theme and the KeepIt theme, the calmato theme has the following modifications.

* Custom **Header**
* Custom **CSS Style**
* A new **home page**, compatible with the latest version of Hugo
* A lot of **style detail adjustments,** including color, font size, margins, code preview style
* More readable **dark mode**
* Some beautiful **CSS animations**
* Easy-to-use and self-expanding **table of contents**
* More **social links**, **share sites** and **comment system**
* **Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/)
* **Copy code** to clipboard with one click
* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**
* Extended Markdown syntax for **ruby annotation**
* Extended Markdown syntax for **fraction**
* **Mathematical formula** supported by [KaTeX](https://katex.org/)
* **Diagram syntax** shortcode supported by [mermaid](https://github.com/knsv/mermaid)
* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)
* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* Embedded **music player** supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)
* **Bilibili** player supported
* Kinds of **admonitions** shortcode supported
* Custom style shortcodes supported
* **CDN** for all third-party libraries supported
* **New feature**: Add support to multi-level menu and sub-section pages in [v1.1.0](https://github.com/zdong1995/calmato/releases/tag/1.1.0)

![Submenu and Subsection](https://github.com/zdong1995/calmato/raw/master/images/submenu.gif)

In short,
if you prefer the design language and freedom of the calmato theme,
if you want to use the extended Font Awesome icons conveniently,
if you want to embed mathematical formulas, flowcharts, music or Bilibili videos in your posts,
the calmato theme may be more suitable for you.

I hope you will calmato ❤️!

## Features

### Performance and SEO

* Optimized for **performance**: 99/100 on mobile and 100/100 on desktop in [Google PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights)
* Optimized SEO performance with a correct **SEO SCHEMA** based on JSON-LD
* **[Google Analytics](https://analytics.google.com/analytics)** supported
* **[Fathom Analytics](https://usefathom.com/)** supported
* Search engine **verification** supported (Google, Bind, Yandex and Baidu)
* **CDN** for third-party libraries supported
* Automatically converted images with **Lazy Load** by [lazysizes](https://github.com/aFarkas/lazysizes)

### Appearance and Layout

* **Responsive** layout
* **Light/Dark** mode
* Globally consistent **design language**
* **Pagination** supported
* Easy-to-use and self-expanding **table of contents**
* **Multilanguage** supported and i18n ready
* Beautiful **CSS animation**

### Social and Comment Systems

* **Gravatar** supported by [Gravatar](https://gravatar.com)
* Local **Avatar** supported
* Up to **64** social links supported
* Up to **28** share sites supported
* **Disqus** comment system supported by [Disqus](https://disqus.com)
* **Gitalk** comment system supported by [Gitalk](https://github.com/gitalk/gitalk)
* **Valine** comment system supported by [Valine](https://valine.js.org/)
* **Facebook comments** system supported by [Facebook](https://developers.facebook.com/docs/plugins/comments/)
* **Telegram comments** system supported by [Telegram Comments](https://comments.app/)
* **Commento** comment system supported by [Commento](https://commento.io/)
* **Utterances** comment system supported by [Utterances](https://utteranc.es/)

### Extended Features

* **Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/)
* **Twemoji** supported
* Automatically **highlighting** code
* **Copy code** to clipboard with one click
* **Images gallery** supported by [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)
* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**
* Extended Markdown syntax for **ruby annotation**
* Extended Markdown syntax for **fraction**
* **Mathematical formula** supported by [KaTeX](https://katex.org/)
* **Diagrams** shortcode supported by [mermaid](https://github.com/knsv/mermaid)
* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)
* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* **Music player** shortcode supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)
* **Bilibili player** shortcode
* Kinds of **admonitions** shortcode
* **Custom style** shortcode
* **Custom script** shortcode
* **Animated typing** supported by [TypeIt](https://typeitjs.com/)
* **Dynamic scroll** supported by [Smooth Scroll](https://github.com/cferdinandi/smooth-scroll)
* **Cookie consent banner** supported by [cookieconsent](https://github.com/osano/cookieconsent)
* ...

## [Documentation](https://calmato.netlify.app/categories/documentation/)

Build Documentation Locally:

```bash
hugo server --source=exampleSite
```

## Multilingual and i18n

calmato supports the following languages:

* English
* Simplified Chinese
* French
* Polish
* Brazilian Portuguese
* Italian
* Spanish
* German
* Serbian
* Russian
* Romanian
* Vietnamese
* [Contribute with a new language](https://github.com/zdong1995/calmato/pulls)

[Languages Compatibility](https://calmato.netlify.app/theme-documentation-basics/#language-compatibility)

## [Roadmap](https://github.com/zdong1995/calmato/projects/1)

## Questions, ideas, bugs, pull requests

All feedback is welcome! Head over to the [issue tracker](https://github.com/zdong1995/calmato/issues).

## License

calmato is licensed under the **MIT** license. Check the [LICENSE file](https://github.com/zdong1995/calmato/blob/master/LICENSE) for details.

Thanks to the authors of following resources included in the theme:

* [normalize.css](https://github.com/necolas/normalize.css)
* [Font Awesome](https://fontawesome.com/)
* [Simple Icons](https://github.com/simple-icons/simple-icons)
* [Animate.css](https://daneden.github.io/animate.css/)
* [Smooth Scroll](https://github.com/cferdinandi/smooth-scroll)
* [autocomplete.js](https://github.com/algolia/autocomplete.js)
* [Lunr.js](https://lunrjs.com/)
* [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript)
* [lazysizes](https://github.com/aFarkas/lazysizes)
* [object-fit-images](https://github.com/fregante/object-fit-images)
* [Twemoji](https://github.com/twitter/twemoji)
* [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)
* [clipboard.js](https://github.com/zenorocha/clipboard.js)
* [Sharer.js](https://github.com/ellisonleao/sharer.js)
* [TypeIt](https://typeitjs.com/)
* [KaTeX](https://katex.org/)
* [mermaid](https://github.com/knsv/mermaid)
* [ECharts](https://echarts.apache.org/)
* [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* [APlayer](https://github.com/MoePlayer/APlayer)
* [MetingJS](https://github.com/metowolf/MetingJS)
* [Gitalk](https://github.com/gitalk/gitalk)
* [Valine](https://valine.js.org/)
* [cookieconsent](https://github.com/osano/cookieconsent)

## Author

[zdong1995](https://dongxiaoran.com)

## Sponsor

If you enjoy the theme, please consider buying me a coffee ☕️.

* [PayPal](https://paypal.me/zdong1995)

Thanks! ❤️
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hugo-PaperMod

hugo-PaperMod

A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.

Hugo · Portfolio

LoveIt

LoveIt

LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.

Hugo · Blog

hugo-coder

hugo-coder

hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.

Hugo · Blog

blowfish

blowfish

Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.

Hugo · Blog

hugo-paper

hugo-paper

hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.

Hugo · Blog

hextra

hextra

Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.

Hugo · Documentation