这篇文章将带你快速掌握在 Hugo 中撰写高质量内容的技巧。从最基础的文字排版,到图片管理,再到复杂的数学公式渲染,这里都有最标准的参考写法。
1. 基础排版与引用
在 Hugo 中,良好的层级结构有助于 SEO 和阅读体验。你可以使用标准的 Markdown 语法来排版。
引用示例
所谓“静态网站生成器”,本质上是在你发布之前,将 Markdown 源文件预先编译成 HTML 文件的过程。这种架构极大地提升了网站的安全性与访问速度。
2. 页面包 (Page Bundle) 模式
你现在的博客结构已经采用了 Page Bundle 模式。这意味着:
- 文章文件夹化:每篇文章都有自己的文件夹。
- 资源同级化:图片、附件直接放在
index.md旁边即可引用。
图片引用
如果你在文件夹里放了一张 cover.jpg,引用方式非常简单:

3. 代码高亮
Hugo 内置了强悍的代码高亮引擎。
| |
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 驱动 |
| 图片处理 | ✅ 支持 | 可自动缩放和剪裁 |
| 多语言支持 | ✅ 支持 | 现已配置中文 |