Markdown 排版速查

这篇的用途很单纯：把常用语法都写一遍，改样式之后回来对照，一眼就能看出哪块被改坏了。

标题层级

正文里用 ## 和 ### 就够了。# 留给页面标题，写在正文里会和文章标题打架。

文本样式

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

列表

无序：

• 第一项
• 第二项
  • 嵌套一层
  • 再一层

有序：

1. 第一步
2. 第二步
3. 第三步

引用

引用块用来放结论或原文摘录。 可以连续多行。

代码

行内用反引号写 hugo server -D。

围栏代码块（指定语言会有语法高亮）：

const posts = await fetch("/api/posts").then((r) => r.json());
posts
  .filter((p) => !p.draft)
  .sort((a, b) => new Date(b.date) - new Date(a.date));

def reading_time(text: str, wpm: int = 250) -> int:
    return max(1, round(len(text.split()) / wpm))

[pagination]
  pagerSize = 5

表格

分隔线

下面是一条分隔线：

图片

后台的「封面图」字段会填到 front matter 的 cover，由模板单独渲染。 正文里插图片则直接走 Markdown 语法，上传后路径是 /images/uploads/xxx.png：

![图片说明](/images/uploads/example.png)

提示：正文里的图片路径要以 / 开头，用绝对路径。 相对路径在 Hugo 的多层 URL 结构下极易失效。