HugoBlog

LoveIt — Hugo Blog Template

By bestlucky0825

LoveIt is a Hugo-based blog theme that emphasizes a clean and elegant appearance, and extends LeaveIt and KeepIt with shortcode capabilities such as search, comments, mathematical formulas, charts, and a music player.

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-11View source

What stands out

A quick read of the recorded project description.

01

Hugo-based blog theme providing a responsive layout and light/dark mode switching

02

Supports Lunr.js or Algolia search, as well as various third-party comment systems

03

Extends Markdown through shortcodes, allowing embedding of KaTeX formulas, mermaid diagrams, ECharts visualizations, Mapbox maps, music, and Bilibili players

04

Supports multilingual and i18n, with built-in pagination and an auto-expanding table of contents

05

Provides extended Markdown syntax such as Font Awesome icons, ruby annotations, and fractions

06

Licensed under MIT, permitting free use, modification, commercial use, and distribution of this version of the code

Template Details

LoveIt is a blog theme for Hugo, positioned as "clean, elegant, and advanced." It is developed from the LeaveIt and KeepIt themes, with adjustments and extensions to the header, CSS styles, homepage, dark mode, table of contents, social links, sharing sites, and comment systems. The theme supports multilingual and i18n, includes a responsive layout and light/dark mode switching, and provides pagination and an auto-expanding table of contents.

For content extensions, LoveIt supports Font Awesome icons, ruby annotations, fractions, KaTeX mathematical formulas, mermaid diagrams, ECharts interactive data visualization, Mapbox maps, APlayer/MetingJS music player, Bilibili player, and various admonition blocks through shortcodes, and also supports custom style and custom script shortcodes. Search can be provided by Lunr.js or Algolia, and the comment system can be Disqus, Gitalk, Valine, Facebook, Telegram, Commento, utterances, giscus, etc.

The theme comes with an example site, and the documentation can be built locally with hugo server --source=exampleSite. The Hugo version requirement noted in the repository is ^0.62.0, but the actual dependency versions should be based on the actual dependency manifest. Before use, note that demo images, fonts, icons, and other third-party assets need to be checked against their respective licenses and cannot be judged solely by the MIT license of the code; external services such as domains, hosting, databases, payments, or AI may incur additional charges.

HugoBlog

Is it right for your project?

Use Cases

  • Building a personal technical blog or writing site that needs light/dark mode, a table of contents, and code highlighting
  • Embedding mathematical formulas, flowcharts, data visualizations, or maps in articles
  • Configuring Algolia or Lunr.js search for a blog and integrating comment systems such as Disqus, Gitalk, or utterances
  • Building a multilingual blog that requires i18n and multilingual content management
  • Embedding a music player or Bilibili videos in articles

Suitable For

  • Developers or writers using Hugo as a static site generator
  • Blog authors who need extended Markdown syntax and shortcode capabilities
  • Site maintainers who want to choose their own search and comment services and integrate third-party libraries
  • Individuals or teams needing a multilingual blog and responsive layout

Getting started & customization

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

  1. 1

    The theme requires Hugo version ^0.62.0; actual dependency versions should be based on the dependency manifest

  2. 2

    You can run hugo server --source=exampleSite to build the example site and documentation locally

  3. 3

    Search requires choosing between Lunr.js and Algolia and completing the corresponding configuration

  4. 4

    The comment system must be configured separately for the chosen service (such as Disqus, Gitalk, Valine, utterances, giscus, etc.)

  5. 5

    Third-party assets such as demo images, fonts, and icons need to be checked against their respective licenses, and external services may incur additional charges

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 this version and does not mean that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version of the code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete 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 against their respective licenses and cannot be judged solely by the MIT license of the code.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
  • Search functionality requires choosing between Lunr.js or Algolia; if Algolia is chosen, you need to register an Algolia account and configure its external search service.
  • The comment system is an optional integration; enabling Disqus requires registration and depends on Disqus as an external third-party service.
  • Enabling Gitalk comments depends on external configurations such as a GitHub account and a GitHub OAuth application.
  • Enabling Valine comments requires configuring external backend services such as LeanCloud and the corresponding keys.
  • Using the Mapbox shortcode depends on the Mapbox GL JS external service and usually requires a Mapbox access token.
  • The music player shortcode depends on the APlayer and MetingJS external libraries and the corresponding music API service.
  • The Bilibili player shortcode depends on the Bilibili external platform embedding service.
  • Third-party libraries may be loaded via CDN, meaning runtime depends on the availability of external CDN services.
  • Sponsorship is voluntary and is not a mandatory payment requirement for using 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

**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

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

Original README

**Music player** shortcode supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)

Original README

**Bilibili player** shortcode

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/bestlucky0825/LoveIt/blob/master/LICENSEhttps://github.com/bestlucky0825/LoveIt/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-11. 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 · 65 / 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
2022-05-30
Screenshot last checked
2026-10-11

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: af603dfcba2ffa43a07201cc432d945041f3654577d79bd81c54604cb4a10336

2026-10-11T21:29:38.181Z

Source file / repository
# LoveIt Theme | Hugo [![Netlify Status](https://api.netlify.com/api/v1/badges/e60303f2-862c-4342-bf59-7c9adb10812e/deploy-status)](https://app.netlify.com/sites/hugo-loveit/deploys)

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/dillonzq/LoveIt?style=flat-square)](https://github.com/dillonzq/LoveIt/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/dillonzq/LoveIt?style=flat-square)](https://github.com/dillonzq/LoveIt/blob/master/LICENSE)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dillonzq_LoveIt&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dillonzq_LoveIt)
[![CircleCI](https://circleci.com/gh/dillonzq/LoveIt/tree/master.svg?style=svg)](https://circleci.com/gh/dillonzq/LoveIt/tree/master)

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

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

It is based on the original [LeaveIt Theme](https://github.com/liuzc/LeaveIt) 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 LoveIt](#why-choose-loveit) so that you can choose the one that works best for you.

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

## [Demo Site](https://hugoloveit.com/)

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

## Why choose LoveIt

Compared to the original LeaveIt theme and the KeepIt theme, the LoveIt 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/mermaid-js/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
* ...

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

I hope you will LoveIt ❤️!

## 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
* **[Plausible Analytics](https://plausible.io/)** 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

* **Desktop/Mobile 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 **67** social links supported
* Up to **24** 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/)
* **giscus** comment system supported by [giscus](https://giscus.app/)

### 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](https://github.com/sachinchoolur/lightgallery)
* 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/mermaid-js/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/)
* **Cookie consent banner** supported by [cookieconsent](https://github.com/osano/cookieconsent)
* ...

## [Documentation](https://hugoloveit.com/categories/documentation/)

Build Documentation Locally:

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

## Multilingual and i18n

LoveIt supports the following languages:

* English
* Simplified Chinese
* Traditional Chinese
* French
* Polish
* Brazilian Portuguese
* Italian
* Spanish
* German
* Serbian
* Russian
* Romanian
* Vietnamese
* Arabic
* Catalan
* Thai
* Telugu
* Indonesian
* [Contribute with a new language](https://github.com/dillonzq/LoveIt/pulls)

[Languages Compatibility](https://hugoloveit.com/theme-documentation-basics/#language-compatibility)

## [Roadmap](https://github.com/dillonzq/LoveIt/projects/1)

## Questions, ideas, bugs, pull requests

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

## License

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

## Special Thanks

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/)
* [autocomplete](https://github.com/algolia/autocomplete)
* [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)
* [emoji-data](https://github.com/iamcal/emoji-data)
* [lightGallery](https://github.com/sachinchoolur/lightgallery)
* [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/mermaid-js/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

[Dillon](https://dillonzq.com)

## Sponsor

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

* [PayPal](https://paypal.me/dillonzq)
* [Alipay](https://github.com/dillonzq/LoveIt/raw/master/images/Alipay.jpg)
* [Wechat](https://github.com/dillonzq/LoveIt/raw/master/images/Wechat.jpg)

Thanks! ❤️

## Stargazers over time

[![Stargazers over time](https://starchart.cc/dillonzq/LoveIt.svg)](https://starchart.cc/dillonzq/LoveIt)
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