Markdown 脚注(Footnote)用法示例
2026-09-06·
·
2 分钟阅读时长
Mizar Zenith
写文章时,有时需要给正文里的说法补充参考资料或额外说明,但又不想打断阅读节奏——这就是脚注的用途。
基本用法
在正文需要标注的地方写一个 [^标签],然后在文章任意位置(通常在文末)给出对应的解释:
这是正文里的一个观点[^1]。
[^1]: 这是脚注的解释内容。
渲染后,正文处会出现一个上标的引用编号,文章末尾自动生成脚注列表;点击编号跳到脚注,再点击脚注末尾的 ^ 符号就能跳回正文。
实际效果演示
下面这段文字里用了三个脚注,注意看正文的上标标记和文末的脚注列表:
Hugo 是一款用 Go 语言编写的静态网站生成器1,默认使用 Goldmark 来渲染 Markdown2。脚注的标签既可以用数字,也可以用有意义的文字(比如 [^note]),最终编号都会由 Hugo 自动按顺序生成3。
小提示
- 脚注定义放在文末即可,Hugo 会自动把它们收集到页面底部的脚注区块。
- 脚注里也可以写链接、加粗等 Markdown 语法。
- 脚注末尾那个返回链接的样式(本站显示为上标的 ^),由
config/_default/hugo.yaml里的markup.goldmark.extensions.footnote.backlinkHTML控制。
