HugoHTMLBlog

amp-blog-theme — Hugo Blog Template

By qtopie

A Hugo-based AMP blog theme that provides AMP pages, Google Analytics and AdSense integration, and an image lightbox.

Open Source Site Download Source ZIP

Explore the design

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

2 previews

Desktop homepage1 / 2

Visit websiteOpens in a new tab

Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-03View source

What stands out

A quick read of the recorded project description.

Outputs AMP pages for blogs

Built-in Google Analytics and Google AdSense configuration options

Provides AMP Image Lightbox image viewing effect

Includes a complete config.yaml example, including Goldmark and code highlighting settings

LaTeX math formulas and GitHub markdown layout are not yet implemented

Template Details

amp-blog-theme is a Hugo blog theme intended to generate AMP-compliant pages for blogs. The repository description lists implemented features including AMP pages, Google Analytics, Google AdSense, and AMP Image Lightbox; LaTeX (math formula) support and GitHub markdown layout are still marked as incomplete.

The theme includes a sample config.yaml covering baseURL, language, title, author information, as well as Goldmark extension and parser options (such as definition lists, footnotes, tables, task lists, automatic heading IDs, etc.), code highlighting settings, and table of contents level range. The README does not provide installation steps, content structure explanation, or a list of page types; actual use requires combining Hugo's own theme installation method and configuration conventions.

The theme is released under the MIT license, allowing free use, modification, commercial use, and distribution of code copies, but third-party assets such as demo images, fonts, and icons require separate license verification.

HugoHTMLBlog

Is it right for your project?

Use Cases

Building a personal blog with AMP pages as the primary output format
Needing to integrate Google Analytics tracking and AdSense ads into a blog
Wanting to manage content with Hugo and customize Markdown rendering and code highlighting

Suitable For

Developers using Hugo to build blogs
Content sites requiring AMP page output
Users who accept supplementing installation and content structure documentation themselves

Getting started & customization

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

1
The theme must be installed as a Hugo theme; the README does not provide specific commands, please refer to the official Hugo theme documentation
2
Configuration can reference the config.yaml example provided in the repository, modifying baseURL, title, author, and Goldmark options as needed
3
Google Analytics and AdSense require providing the corresponding account and identifiers yourself
4
LaTeX math formulas and GitHub markdown layout are not currently supported in this version

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 external services or third-party assets are free.

Must comply with when using

Permits free use, modification, commercial use, and distribution of this version's code.
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

Using Google Analytics functionality requires providing your own Google Analytics account and tracking identifier, which is an external service dependency.
Using Google AdSense functionality requires applying for and holding a Google AdSense account, which is an external service dependency.
Demo images, fonts, icons, and other third-party assets must 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.

View Original Text Basis

Permission is hereby granted, free of charge
Original License Text

Google Analytics
Original README

Google AdSense
Original README

https://github.com/qtopie/amp-blog-theme/blob/main/LICENSE https://github.com/qtopie/amp-blog-theme/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-03. 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 · 71 / 100
Technologies: Hugo · HTML
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: 2025-03-24
Screenshot last checked: 2026-10-03

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

2026-10-03T00:55:52.338Z

Source file / repository

# amp-blog-theme

A simple blog theme supports for [AMP](https://amp.dev/).

## Features

- [x] AMP Page
- [x] Google Analytics
- [x] Google AdSense
- [x] AMP Image Lightbox
- [ ] Latex (Math) Support
- [ ] GitHub markdown layout

## Example Configuration

**config.yaml**

```yaml
baseURL: 'https://your-site.com/'
languageCode: 'en-us'
defaultContentLanguage: en
title: 'Blog | authorName'
theme: 'amp-blog-theme'
author: 
  name: 'authorName'
  email: [email protected]

markup:
  defaultMarkdownHandler: goldmark
  goldmark:
    extensions:
      definitionList: true
      footnote: true
      linkify: true
      strikethrough: true
      table: true
      taskList: true
      typographer: true
    parser:
      attribute:
        block: false
        title: true
      autoHeadingID: true
      autoHeadingIDType: github
    renderer:
      hardWraps: false
      unsafe: false
      xhtml: false
  highlight:
    anchorLineNos: false
    codeFences: true
    guessSyntax: false
    hl_Lines: ""
    lineAnchors: ""
    lineNoStart: 1
    lineNos: false
    lineNumbersInTable: true
    noClasses: true
    style: manni
    tabWidth: 2
  tableOfContents:
    endLevel: 3
    ordered: false
    startLevel: 2
```

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