LoveIt is a clean and elegant blog theme for the Hugo static site generator, built as a fork of the LeaveIt and KeepIt themes and extended with search, dark mode, and media shortcodes.
What is LoveIt?
LoveIt is a blog theme for Hugo that turns content written in Markdown into a static website with a responsive, mobile-friendly layout. It is created by Dillon (dillonzq) and licensed under MIT. The theme accepts Hugo site configuration and content files as input, and produces a fully generated static site with features like light/dark mode, pagination, and a table of contents. It supports Hugo versions from 0.128.0 up to the latest master build.
Key Features
- Search — Integrated with Lunr.js or Algolia so visitors can search your blog with a self-expanding autocomplete.
- Comment systems — Supports Disqus, Gitalk, Valine, Facebook Comments, Telegram Comments, Commento, utterances, and giscus, giving you eight ways to enable discussion on posts.
- Extended Markdown — Adds Font Awesome icons, ruby annotation, and fraction syntax to standard Markdown, plus custom style and script shortcodes.
- Math and diagrams — Renders KaTeX mathematical formulas, mermaid flowcharts, ECharts interactive visualizations, and Mapbox GL JS maps inside posts.
- Media shortcodes — Embeds APlayer/MetingJS music players, Bilibili players, and lightGallery image galleries with ease.
- SEO and analytics — Includes JSON-LD SEO schema, Google Analytics, Fathom Analytics, Plausible Analytics, Yandex Metrica, and search engine verification for Google, Bind, Yandex, and Baidu.
- Performance — Reports a 99/100 mobile and 100/100 desktop PageSpeed Insights score, with lazy-loaded images via lazysizes.
- Multilingual — Ships with 24 languages, including English, Simplified Chinese, Traditional Chinese, French, Polish, Portuguese (Brazil), Italian, Spanish, German, Serbian, Russian, Romanian, Vietnamese, Arabic, Catalan, Thai, Telugu, Indonesian, Turkish, Korean, Hindi, Dutch, Bengali, and Japanese.
Who is it for?
- Hugo bloggers who want a refined, themeable blog with a modern look and built-in dark mode.
- Technical writers who need to display mathematics, flowcharts, or code snippets with syntax highlighting and copy-to-clipboard buttons.
- Content creators with international audiences who need i18n support across 24 languages and the ability to contribute new translations.
- Developers who want to customize the theme using shortcodes for personalized styles, scripts, and embedded media.
What can you do with LoveIt?
- Technical bloggers: Embed KaTeX equations and mermaid diagrams directly into Markdown posts for clear technical explanations.
- Music lovers: Add an APlayer music player with MetingJS to any page, pulling tracks from supported sources.
- Video creators: Insert Bilibili videos with a dedicated shortcode rather than hand-coding an iframe.
- SEO-focused sites: Enable Google Analytics, Plausible, or Fathom and rely on the JSON-LD schema to structure content for search engines.
How does LoveIt work?
Install LoveIt by placing the theme folder in your Hugo site's themes directory and referencing it in your site configuration. To preview the bundled example site, run hugo server --source=exampleSite. The theme version determines the Hugo version you need: the recommended 0.3.X release works with Hugo 0.128.0–0.145.0, the master branch requires Hugo 0.146.0 or newer, and the older 0.2.X supports Hugo 0.68.0–0.127.0.
Alternatives
LoveIt is a fork of the LeaveIt and KeepIt Hugo themes, which share a similar visual style with fewer features. If you want a simpler theme, one of those originals may be a lighter choice.
FAQ
Is LoveIt free?
Yes, LoveIt is open source and licensed under the MIT license, so you can use it for personal or commercial projects without cost.
What Hugo versions are compatible with LoveIt?
The recommended 0.3.X release supports Hugo 0.128.0 through 0.145.0. The master branch is unstable and requires Hugo 0.146.0 or newer, while the outdated 0.2.X branch supports Hugo 0.68.0 to 0.127.0.
Does LoveIt have search?
Yes, LoveIt offers client-side search powered by either Lunr.js or Algolia, with a built-in autocomplete interface.
Which comment systems does LoveIt support?
LoveIt supports eight comment systems: Disqus, Gitalk, Valine, Facebook Comments, Telegram Comments, Commento, utterances, and giscus.
Can I translate LoveIt into my own language?
Yes, LoveIt is i18n-ready and already supports 24 languages. You can also contribute a new language via a pull request to the GitHub repository.
