HugoBlog

DoIt — Hugo Blog Template

By HEIGE-PCloud

DoIt is a Hugo blog theme maintained by HEIGE-PCloud, developed from LoveIt, LeaveIt, and KeepIt, under the MIT license, with a demo site and full documentation.

Open Source Site Download Source ZIP

Explore the design

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

3 previews

Desktop homepage1 / 3

Visit websiteOpens in a new tab

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-09-30View source

What stands out

A quick read of the recorded project description.

A Hugo blog theme developed from LoveIt, LeaveIt, and KeepIt, with the repository under the MIT license

Provides responsive layout, light and dark modes, pagination, expandable table of contents, multilingual and i18n support, and PWA compatibility

Supports KaTeX formulas, mermaid diagrams, ECharts, Mapbox, music, and Bilibili players via extended Markdown and shortcodes

Supports algolia, Fuse.js, and Pagefind search, as well as many comment systems such as Disqus, Waline, Twikoo, and giscus

Can integrate with multiple statistics and search engine verification services, and supports multiple authors, third-party library CDNs, and remote image caching

Template Details

DoIt is a blog theme for Hugo, maintained by HEIGE-PCloud, with the repository under the MIT license. It is developed from the LoveIt, LeaveIt, and KeepIt themes, inheriting their features and adding new features and optimizations. The theme is positioned to let users go straight to content creation without dealing with complex technical details.

For content presentation, DoIt provides responsive layout, light and dark modes, pagination, expandable table of contents, multilingual and i18n support, CSS animations, and a page layout optimized for wide screens and PWA compatibility. At the article level, it supports code highlighting and one-click code copying, image galleries, Twemoji, and Font Awesome icons, ruby annotations, and fraction notation via extended Markdown syntax; it also provides shortcodes for KaTeX math formulas, mermaid diagrams, ECharts data visualization, Mapbox maps, APlayer and MetingJS music players, Bilibili player, various admonitions, and custom styles, scripts, and friend links.

For site functionality, the theme supports algolia, Fuse.js, or Pagefind search, up to 64 social links and 28 sharing sites, and integrates with many comment systems such as Disqus, Gitalk, Valine, Waline, Twikoo, Vssue, Remark42, giscus, Artalk, Utterances, Commento, Facebook comments, and Telegram comments. For statistics and verification, it supports Google Analytics, Fathom, Baidu Analytics, Umami, Plausible, Cloudflare Web Analytics, Splitbee, Matomo, as well as search engine verification for Google, Bing, Yandex, and Baidu. The theme also supports third-party library CDNs, multiple authors, remote image caching, and a cookie consent banner.

Usage limitations and notes: the performance scores, feature lists, and third-party services listed in the README are the project's own statements and have not been individually verified in this material; third-party resources such as fonts, icons, players, comments, and statistics that the theme depends on have their own licenses and usage conditions, and the MIT license for the code does not cover these assets, nor does it mean external services are free. The repository is updated frequently, and the README explicitly does not recommend downloading the release archive directly because published versions may lag behind.

HugoBlog

Is it right for your project?

Use Cases

Building a personal or technical blog focused on articles with Hugo
Embedding math formulas, flowcharts, data visualization charts, or music and video content in articles
Blog projects that need multilingual sites, light and dark mode switching, and site search
Migrating from the LoveIt theme to a more feature-rich Hugo theme

Suitable For

Developers building static blogs with Hugo
Writers who need to embed rich content forms such as formulas, charts, and players in articles
Blog sites that need multilingual, multi-author, or multiple comment system integrations
Users who already use LoveIt and want to migrate to a theme that continues its design

Getting started & customization

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

1
Recommended to add the repository to the site directory as a git submodule: git submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt
2
Change theme to DoIt in config.toml; when migrating from LoveIt, only this configuration item needs to be changed
3
The README does not recommend downloading the release archive because the repository is updated frequently and published versions may lag behind
4
To build the documentation locally, run hugo server --source=exampleSite
5
Before use, check the respective licenses and fees for third-party assets and services such as fonts, icons, players, comments, and statistics

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; 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 allowed.
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 liability limitations are governed by the original license and applicable law.

Additional costs & items to verify

The README does not recommend downloading the release archive because the repository is updated frequently and published versions may lag behind; it is recommended to include it as a git submodule and update regularly.
The Mapbox map shortcode depends on Mapbox GL JS; using this feature usually requires a Mapbox account and access token, which may incur external service fees.
algolia search requires registering an Algolia account and configuring API keys, which is an external service; Fuse.js and Pagefind are local solutions.
Comment systems such as Disqus require registering an account on the corresponding third-party platform and configuring the site identifier; comment data is hosted on external services.
Statistics services such as Google Analytics, Fathom, Baidu Analytics, Umami, Plausible, Cloudflare, Splitbee, and Matomo require registering accounts and configuring them yourself; some are paid services.
The theme includes third-party resources such as Font Awesome, Simple Icons, KaTeX, mermaid, ECharts, APlayer, MetingJS, lightgallery.js, and TypeIt, each under its own license; the MIT code license does not cover these assets.
Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
External services such as domain names, hosting, databases, payments, or AI may incur additional charges.

View Original Text Basis

Permission is hereby granted, free of charge
Original License Text

Not recommended, the repo is being updated frequently so the releases may out of date.
Original README

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

**Search** supported by [algolia](https://www.algolia.com/), [Fuse.js](https://fusejs.io/) or [Pagefind](https://pagefind.app)
Original README

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

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

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

https://github.com/HEIGE-PCloud/DoIt/blob/main/LICENSE https://github.com/HEIGE-PCloud/DoIt/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-09-30. 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: More documented · 91 / 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: 2026-09-30
Screenshot last checked: 2026-09-30

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.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: b3955a3cf032bcae24b7bdb802055f12732f7a333dfa8cd8a087bbe7947a1593

2026-09-30T09:39:38.612Z

Source file / repository

# DoIt Theme | Hugo

English README | [简体中文说明](https://github.com/HEIGE-PCloud/DoIt/blob/main/README.zh-cn.md)

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

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

The DoIt theme inherits the excellent functions of these themes, and adds new functions and optimizations on this basis. Please read [Why Choose DoIt](#why-choose-doit) to learn more.

The goal of DoIt theme is to create a powerful and easy-to-use Hugo theme, so you can go straight into your blog content creation and just **do it** without worrying about the complex technical details.

## Getting started

Head to this [documentation page](https://hugodoit.pages.dev/theme-documentation-basics/) for a complete guidance to get started with the DoIt theme.

## Migrate from LoveIt

If you are currently using the LoveIt theme, it is very easy to migrate to DoIt.

You can add this repo as a submodule of your site directory.

```bash
git submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt
```

And later you can update the submodule in your site directory to the latest commit using this command:

```bash
git submodule update --remote --merge
```

Alternatively, you can download the [latest release .zip file](https://github.com/HEIGE-PCloud/DoIt/releases) of the theme and extract it in the themes directory. (Not recommended, the repo is being updated frequently so the releases may out of date.)

Next, go to the `config.toml` and change the default theme to `DoIt`.

```diff
- theme = "LoveIt"
+ theme = "DoIt"
```

Now the migration is finished and everything is ready 🎉

Many new features and configurations have been added to the DoIt theme, check the [changelog](https://github.com/HEIGE-PCloud/DoIt/blob/main/CHANGELOG.md) and [documentation](https://hugodoit.pages.dev/) for more information.

## [Demo Site](https://hugodoit.pages.dev/)

To see this theme in action, here is a live [demo site](https://hugodoit.pages.dev/) which is rendered with **DoIt** theme.

## Why choose DoIt

* 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 [algolia](https://www.algolia.com/), [Fuse.js](https://fusejs.io/) or [Pagefind](https://pagefind.app)
* **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
* **Multiple Authors** supported
* ...

In short,
if you prefer the design language and freedom of the DoIt 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 DoIt theme may be more suitable for you.

## 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
* **[Baidu Analytics](https://tongji.baidu.com/)** supported
* **[Umami Analytics](https://umami.is/)** supported
* **[Plausible Analytics](https://plausible.io/)** supported
* **[Cloudflare Web Analytics](https://www.cloudflare.com/web-analytics)** supported
* **[Splitbee Analytics](https://splitbee.io)** supported
* **[Matomo Analytics](http://www.matomo.com/)** supported
* Search engine **verification** supported (Google, Bind, Yandex and Baidu)
* **CDN** for third-party libraries supported

### 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**
* Brand new **Page Layout** optimized for wide screens
* Compatibility for **PWA**

### 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/)
* **Waline** comment system supported by [Waline](https://waline.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/)
* **Twikoo** comment system supported by [Twikoo](https://twikoo.js.org/)
* **Vssue** comment system supported by [Vssue](https://vssue.js.org/)
* **Remark42** comment system supported by[Remark42](https://remark42.com/)
* **giscus** comment system supported by [giscus](https://giscus.app/)
* **Artalk** comment system supported by [Artalk](https://artalk.js.org/)

### Extended Features

* **Search** supported by [algolia](https://www.algolia.com/) or [Fuse.js](https://fusejs.io/)
* **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
* **Custom friend** shortcode
* **Animated typing** supported by [TypeIt](https://typeitjs.com/)
* **Dynamic scroll** supported by native CSS
* **Cookie consent banner** supported by [cookieconsent](https://github.com/osano/cookieconsent)
* Option to **cache remote images**
* ...

## [Documentation](https://hugodoit.pages.dev/categories/documentation/)

Build Documentation Locally:

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

## Multilingual and i18n

DoIt supports the following languages:

* English
* Simplified Chinese
* French
* Polish
* Brazilian Portuguese
* Italian
* Spanish
* German
* Serbian
* Russian
* Romanian
* Vietnamese
* Arabic
* Catalan
* Hindi
* Indonesian
* Korean
* European Portuguese
* Tegulu
* Thai
* Turkish
* Ukrainian
* Traditional Chinese
* [Contribute with a new language](https://github.com/HEIGE-PCloud/DoIt/pulls)

[Languages Compatibility](https://hugodoit.pages.dev/theme-documentation-basics/#language-compatibility)

## [Roadmap](https://github.com/HEIGE-PCloud/DoIt/projects/1)

## [Changelog](https://github.com/HEIGE-PCloud/DoIt/blob/main/CHANGELOG.md)

## Questions, ideas, bugs, pull requests

All feedback is welcome! Head over to the [issue tracker](https://github.com/HEIGE-PCloud/DoIt/issues).

## License

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

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

* [Font Awesome](https://fontawesome.com/)
* [Simple Icons](https://github.com/simple-icons/simple-icons)
* [autocomplete.js](https://github.com/algolia/autocomplete.js)
* [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript)
* [Fuse.js](https://fusejs.io/)
* [object-fit-images](https://github.com/fregante/object-fit-images)
* [Twemoji](https://github.com/twitter/twemoji)
* [lightgallery.js](https://github.com/sachinchoolur/lightgallery.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/)
* [Waline](https://waline.js.org/)
* [Twikoo](https://twikoo.js.org/)
* [Vssue](https://vssue.js.org/)
* [Remark42](https://remark42.com/)
* [cookieconsent](https://github.com/osano/cookieconsent)

## Author

[PCloud](https://github.com/HEIGE-PCloud)

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

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 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 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 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 is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.

Hugo · Blog

hextra

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

Hugo · Documentation