Markdown 语法大全：一篇看尽常用排版
这是一篇 Markdown 语法展示文。下文按类别列出 Hugo + Goldmark（GFM）支持的常见写法，便于对照源码与渲染效果。站点已开启 unsafe = true，因此文末也包含少量原始 HTML 示例。
标题层级
正文通常从二级标题开始；一级标题由页面模板中的文章标题承担。
三级标题
四级标题
五级标题
六级标题
段落与换行
普通段落之间空一行即可分段。
若要在同一段内强制换行，
可在行末保留两个空格（上一行末尾有两个不可见空格）。
也可以用反斜杠硬换行：
这是换行后的第二行。
强调与删除
| 效果 | 写法 | 示例 |
|---|---|---|
| 斜体 | *text* 或 _text_ | 这是斜体 |
| 粗体 | **text** | 这是粗体 |
| 粗斜体 | ***text*** | 这是粗斜体 |
| 删除线 | ~~text~~ |
行内代码：const answer = 42，或 `反引号` 本身用双反引号包裹。
链接
行内链接： 访问 Hugo 官方文档 了解更多。 自动链接： https://gohugo.io 会被识别为可点击 URL。 引用式链接： 这是 [站内首页][home] 与 [外部引用][hugo-ref] 的组合写法。 锚点跳转： 跳转到本文 表格 小节。 [home]: / [hugo-ref]: https://gohugo.io/ “Hugo 项目主页”
引用块
单层引用：
写作是把模糊的感受，
变成可以被他人阅读的句子。
嵌套引用：
外层引用
内层引用
引用里也可以有 粗体 与
行内代码。
列表
无序列表
- 第一项
- 第二项
- 嵌套子项 A
- 嵌套子项 B
- 更深层嵌套
- 第三项
有序列表
- 先写草稿
- 再改结构
- 最后润色
- 检查错别字
- 调整段落节奏
任务列表
- 标题与段落
- 强调、链接与引用
- 代码块与表格
- 按需继续补充扩展语法
混合列表
- 准备环境
- 安装 Hugo
- 克隆主题仓库
- 本地预览
- 运行
hugo server -D
- 运行
- 发布上线
代码
行内代码
在段落中嵌入 npm install、<div> 或 `反引号` 都不会破坏排版。
围栏代码块
function greet(name) {
return `Hello, ${name}!`;
}
console.log(greet("Markdown"));[markup.goldmark.renderer]
unsafe = true
[markup.highlight]
style = "github"hugo server -D --disableFastRender
curl -I https://example.org/- old line
+ new line
context line
package main
import "fmt"
func main() {
fmt.Println("Hello, Hugo!")
}无语言标注的纯文本块：
这是一段不带语法高亮的围栏代码。
保留原始缩进与空行。表格
基础表格
| 语法 | 示例 | 说明 |
|---|---|---|
| 粗体 | **text** | 强调关键词 |
| 链接 | [label](url) | 站外或站内跳转 |
| 表格 | | col | col | | GFM 表格 |
| 代码 | `code` | 行内或围栏 |
对齐方式
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 左 | 中 | 右 |
| 较长的单元格内容 | 居中 | 100 |
图片
主题通过 render-image.html 为图片包裹 <figure> 并显示说明文字：
引用式图片：
分隔线
下面三种写法都会渲染为水平线：
脚注
定义列表
- 术语一
- 这是术语一的定义，可以写多行说明。
- Hugo
- 基于 Go 的静态站点生成器。
- 也可有多条定义对应同一术语。
- Markdown
- 轻量级标记语言，易读易写。
原始 HTML
因 unsafe = true，下列 HTML 会原样输出（请仅在可信内容中使用）：
Ctrl + C 复制，Ctrl + V 粘贴。
这是一段带内联样式的 HTML 段落，用于演示混合排版。
点击展开更多说明
折叠块内的 Markdown 仍会被解析，例如 粗体 与 code。
转义与特殊字符
需要显示字面量星号、井号或反引号时，用反斜杠转义：*不是斜体*、# 不是标题、`不是代码`。
常见实体也可直接写：© 2026、<tag>。
Typographer 扩展会把 -- 变成 en dash（–），--- 变成 em dash（——），... 变成省略号（…）。
语法速查
若你正在为主题调试样式，可按下面清单逐项核对渲染是否正常：
- 标题 h2–h6
- 强调、删除线与行内代码
- 各类链接（行内 / 引用 / 自动）
- 引用与嵌套引用
- 无序、有序、任务与混合列表
- 多语言代码块与复制按钮
- 表格对齐
- 图片与 figcaption
- 分隔线、脚注、定义列表
- 原始 HTML 与转义字符
全文完毕。若某一项显示异常，优先检查 Goldmark 扩展与主题 CSS 是否覆盖对应元素。