Good SEO with Hugo

本文由 AI 分析生成

建立時間： 2026-03-28 來源： https://iamjeremie.me/post/2024-08/good-seo-with-hugo/

Summary

Practical guide by Jérémie Litzler on improving SEO for Hugo blogs using the Jimmy Cai theme. Covers frontmatter setup for SEO tags, semantic HTML heading corrections, and switching to Hugo from VuePress due to Netlify build minute limits.

Jérémie Litzler 關於使用 Jimmy Cai 主題改善 Hugo 部落格 SEO 的實用指南。涵蓋 SEO 標籤的 frontmatter 設置、語義 HTML 標題修正，以及因 Netlify 建置分鐘限制從 VuePress 遷移到 Hugo。

Key Points

• Hugo: Go-based SSG; Markdown → HTML; extensible via shortcodes and themes
• SEO starts with title and description frontmatter fields (same as VuePress)
• Semantic HTML matters for SEO: h1 must be the first heading — theme had h2 in some layout files
• Fixes required: layouts\_default\archives.html, layouts\page\search.html, layouts\partials\article\components\details.html
• Migration motivation: VuePress exceeded Netlify free build minutes

Insights

The most actionable insight is that even popular, well-maintained themes can ship with semantic HTML violations (using h2 instead of h1 as the first heading), which silently harm SEO. Fixing these requires examining layout templates directly rather than just configuring frontmatter. The VuePress → Hugo migration reason (build time) highlights a practical trade-off between ecosystem richness (VuePress/Vue ecosystem) and raw performance (Hugo is among the fastest SSGs).

Connections

• Hugo
• SEO
• static site generator
• web development

Raw Excerpt

In some places, I had to adjust the theme’s heading elements to comply with the rules of good semantic HTML, important for natural SEO as well as best practices.