这篇不是语法大全，只收录技术笔记里高频使用的那几种，并且都是这个主题下的实际效果。

行内样式

行内代码、加粗、斜体、删除线、链接。

快捷键写 <kbd>Ctrl</kbd> + <kbd>C</kbd> 会渲染成 Ctrl + C。

列表

无序：

  • 第一层
    • 第二层
      • 第三层（再深就不建议了，读者会晕）

有序，适合写步骤：

  1. 先确认 hugo version 大于 0.158
  2. 再执行 hugo server
  3. 最后 git push

任务清单：

  • 搭好框架
  • 配好搜索
  • 写满十篇

表格

列多的时候记得对齐，否则源文件很难维护：

命令作用常用参数
hugo构建到 public/--gc --minify
hugo server本地预览-D 含草稿
hugo new新建内容--kind note

代码块

带语言标注就会高亮：

def fib(n: int) -> int:
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a

不加语言标注时，Hugo 会根据内容猜（guessSyntax 已开启）：

git commit -m "fix: 修复登录态丢失"

指定要高亮的行（hl_lines）：

const cache = new Map();
cache.set("key", heavyCompute());   // 这一行会被标出来

引用

引用块适合放原文摘录、官方文档的说法，或者一句需要强调的结论。

也可以用来区分「我的理解」和「文档原话」。

折叠块

内容长的补充说明可以折起来，避免打断阅读节奏：

点开看完整报错
Error: failed to load module "papermod"
  caused by: module not found

这类报错通常是主题目录名和 theme: 配置不一致导致的。

图片

图片放在 static/images/ 下，正文用绝对路径引用：

![架构图](/images/architecture.png)

不要用本地绝对路径（如 C:\Users\...），构建到云端会全部失效。

分隔线与脚注

三个短横线是分隔线：

这是一句带脚注的话1。

写完之后

扫一眼这几点，能省掉 90% 的返工：

  • 标题层级从 ## 开始，# 留给文章标题（主题会自动渲染）
  • 代码块都标了语言
  • 长文加了 ShowToc: true
  • draft 改成了 false

  1. 脚注内容会渲染在文末，适合放参考链接。 ↩︎