Hugo 写作指南:从入门到精通

这是一篇精心设计的经典示例,展示了 Hugo 页面包结构、Markdown 高级语法及多语言配置的真实用法。

这篇文章将带你快速掌握在 Hugo 中撰写高质量内容的技巧。从最基础的文字排版,到图片管理,再到复杂的数学公式渲染,这里都有最标准的参考写法。

1. 基础排版与引用

在 Hugo 中,良好的层级结构有助于 SEO 和阅读体验。你可以使用标准的 Markdown 语法来排版。

引用示例

所谓“静态网站生成器”,本质上是在你发布之前,将 Markdown 源文件预先编译成 HTML 文件的过程。这种架构极大地提升了网站的安全性与访问速度。

2. 页面包 (Page Bundle) 模式

你现在的博客结构已经采用了 Page Bundle 模式。这意味着:

  1. 文章文件夹化:每篇文章都有自己的文件夹。
  2. 资源同级化:图片、附件直接放在 index.md 旁边即可引用。

图片引用

如果你在文件夹里放了一张 cover.jpg,引用方式非常简单: 本地图片描述

3. 代码高亮

Hugo 内置了强悍的代码高亮引擎。

1
2
3
4
def welcome_hugo():
    message = "Hello, Hugo World!"
    print(message)
    return True

4. 数学公式 (KaTeX)

通过在 Front Matter 中设置 math: true,你可以书写复杂的数学公式:

行内公式:例如黄金分割比例 $\varphi = \dfrac{1+\sqrt5}{2}$。

块级公式

$$ \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } $$

5. 数据表格

表格是展示对比数据的利器:

功能状态备注
Markdown 渲染✅ 支持由 Goldmark 驱动
图片处理✅ 支持可自动缩放和剪裁
多语言支持✅ 支持现已配置中文
为中华之崛起而读书
使用 Hugo 构建
主题 StackJimmy 设计