Markdown 写作速查
目录
Hugo 用 Markdown 写文章。下面这些是最常用的语法，够写 95% 的内容。
标题
一个 # 是一级标题（文章标题已经占用了，正文从 ## 开始）。
## 二级标题
### 三级标题
强调与链接
**加粗**、*斜体*、~~删除线~~
[链接文字](https://example.com)
列表
- 无序列表
- 第二项
- 缩进两级
1. 有序列表
2. 第二项
代码
行内代码用反引号：npm run build。
代码块用三个反引号加语言名，Hugo 会自动做语法高亮：
```python
def greet(name: str) -> str:
return f"你好，{name}"
```
表格
| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| a | b | c |
引用与分割线
> 这是一段引用。
---
文章头部信息（front matter）
每篇文章开头的 --- 之间是元数据，常用的有：
---
title: "文章标题"
date: 2026-11-06T10:00:00+08:00
draft: false # true 时不会发布
tags: ["标签一", "标签二"]
categories: ["分类"]
description: "一句话摘要，会用在搜索结果和分享卡片里"
---
写草稿时把 draft 设为 true，本地用 hugo server -D 预览，发布前改成 false。
两个小技巧
- 摘要默认截取正文开头约 80 个字；想自己指定，就在想要截断的位置单独写一行 `
`。
- 想在某段写原始 HTML 也可以，配置里已经打开了
unsafe，但一般用不上。