2026/04/21

001 标题（headers）

标题（headers）是markdown中用于创建标题的语法。用符号#表示，#号的数量从1到6表示级别从1到6。一级标题通常为文章标题，二级标题通常为章节标题，以此类推。
示例：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果（渲染后显示为标题样式）：

2026/04/22

002 段落（paragraphs）

段落（paragraphs）是markdown中用于创建段落的语法。多行文本之间用空行隔开，不要用空格或者制表符缩进段落。
示例：

1
2
3
这是一个段落。

这是一个段落。

效果：

这是一个段落。

这是一个段落。

2026/04/23

003 换行（line breaks）

在句子末尾加入两个或者多个空格，然后回车即可换行
示例：

1
2
markdown语法-换行   
新的一行。

效果：
markdown语法-换行
新的一行。

除此之外，你还可以使用HTML的标签来实现换行。
示例：

1
2
markdown语法-换行   <br>
新的一行。

效果：
markdown语法-换行
新的一行。

2026/04/26

004 强调（emphasis）

粗体

如果要加粗文本，请在单词或者短语之前和之后添加两个星号（）或者两个下滑线（_）
如果要加粗单词的某个部分，请在该部分之前和之后添加两个星号（），不能使用下滑线（_）
示例：

1
2
3
I just love **bold text**.
I just love __bold text__.
i**just**love

效果：
I just love bold text.
I just love bold text.
ijustlove

斜体

要用斜体显示文本，请在单词或短语前后添加一个星号（asterisk）或下划线（underscore）。要斜体突出单词的中间部分，请在字母前后各添加一个星号，中间不要带空格。
示例：

1
2
3
Italicized text is the *cat's meow*.
_Italics_ can also be done with underscores.
i*just*love

效果：
Italicized text is the cat’s meow.
Italics can also be done with underscores.
ijustlove

粗体和斜体

要同时用粗体和斜体突出显示文本，请在单词或短语的前后各添加三个星号或下划线。
要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格。
示例：

1
2
3
Bold italicized text is the ***cat's meow***.
Bold italicized text is the ___cat's meow___.
i***just***love

效果：
Bold italicized text is the cat’s meow.
Bold italicized text is the cat’s meow.
ijustlove

005 引用（quotes）

要创建引用块，请在引用内容之前添加大于号（>）。
示例：

1
> 这是一个引用。

效果：

这是一个引用。

块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号。
示例：

1
2
3
> 这是一个引用。
>   
> 这是第二段引用。

效果：

这是一个引用。

这是第二段引用。

块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。
示例：

1
2
> 这是一个引用。
>> 这是一个嵌套的引用。

效果：

这是一个引用。

这是一个嵌套的引用。

块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用，你需要进行实验以查看哪些元素有效。
示例：

1
2
3
> 这是一个引用。
> - 这是一个列表项。
> - 这是另一个列表项。

效果：

这是一个引用。

  • 这是一个列表项。
  • 这是另一个列表项。

2026/05/03

006 列表（lists）

列表是 Markdown 中最常用的排版方式之一，分为无序列表、有序列表和任务列表三种。

无序列表

使用 -、* 或 + 作为列表标记，后面加一个空格再接内容。三种符号效果相同，建议统一使用 -。
示例：

1
2
3
- 列表项一
- 列表项二
- 列表项三

效果：

  • 列表项一
  • 列表项二
  • 列表项三
有序列表

使用数字后跟英文句点和空格。实际数字无关紧要，渲染时会自动递增编号。
示例：

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

效果：

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

即使写成这样，也会正确渲染为 1、2、3：

1
2
3
1. 第一步
1. 第二步
1. 第三步
嵌套列表

在子列表项前缩进 2 或 4 个空格（或一个制表符），可以混合使用有序和无序列表。
示例：

1
2
3
4
5
6
1. 第一项
   - 嵌套无序项
   - 另一个嵌套项
2. 第二项
   1. 嵌套有序项
   2. 另一个嵌套项

效果：

  1. 第一项
    • 嵌套无序项
    • 另一个嵌套项
  2. 第二项
    1. 嵌套有序项
    2. 另一个嵌套项
任务列表（GFM 扩展）

使用 - [ ] 表示未完成，- [x] 表示已完成。注意方括号内的空格。
示例：

1
2
3
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项

效果：

  • 已完成任务
  • 未完成任务
  • 待办事项
列表内嵌套其他元素

嵌套段落：列表项内换行后缩进 2 个空格或更多，可继续写入段落内容。
示例：

1
2
3
4
- 第一项

  这里是附加的段落内容。
- 第二项

效果：

  • 第一项

    这里是附加的段落内容。

  • 第二项

嵌套引用：在列表项内缩进后使用 >。
示例：

1
2
- 列表项
  > 这是一条引用

效果：

  • 列表项

    这是一条引用

嵌套代码块：在列表项内缩进 8 个空格（或 2 个制表符）后写代码，或直接使用 fenced 代码块。
示例：

1
2
3
4
- 列表项
  - 子项

        code here

2026/05/06

007 代码（code）

代码是技术写作中最重要的元素之一。Markdown 支持行内代码和代码块两种方式，并且可以通过指定语言实现语法高亮。

行内代码（Inline Code）

使用单个反引号 ` 包裹文本即可标记为行内代码。行内代码会以等宽字体渲染，保留原文的格式和特殊字符。

示例：

1
在文章中提到 `print()` 函数时，可以使用行内代码。

效果：
在文章中提到 print() 函数时，可以使用行内代码。

行内代码也可以放在句子中间：

1
请先运行 `npm install` 安装依赖，再执行 `npm start` 启动项目。

效果：
请先运行 npm install 安装依赖，再执行 npm start 启动项目。

围栏代码块（Fenced Code Blocks）

使用三个反引号 ``` 包裹多行代码，前后各一行独立成块。这是最常用的代码块写法。

示例：
```markdown

1
2
3
这是一段代码块
它保留了换行
和格式

```

效果：

1
2
3
def hello(name):
    print(f"Hello, {name}!")
    return True
语法高亮（Syntax Highlighting）

在开头的三个反引号后面指定编程语言名称，渲染时就会自动着色。

示例：
```python

1
2
3
def hello(name):
    print(f"Hello, {name}!")
    return True

```

效果（带语法颜色）：

1
2
3
def hello(name):
    print(f"Hello, {name}!")
    return True

不同语言使用不同的关键字，常见的有：

代码块标记 语言
```python Python
```javascript 或 ```js JavaScript
```html HTML
```css CSS
```bash 或 ```sh Shell / Bash
```json JSON
```yaml YAML
```java Java
```c C 语言
```cpp 或 ```c++ C++
```go Go
```rust Rust
```sql SQL
```diff 代码差异对比
```markdown Markdown 本身
缩进代码块（Indented Code Blocks）

缩进 4 个空格或 1 个制表符也可以创建代码块。这种方式无法指定语言，不能语法高亮，适合只需要展示纯文本的场景。

示例：

1
2
这是一行缩进代码
这是另一行

效果：

1
2
这是一行缩进代码
这是另一行
代码块内转义反引号

如果代码块内容本身包含三个反引号，可以通过增加外层反引号的数量来解决。

示例（用四个反引号包裹）：
````text

1
2
3
```python
print("hello")
```

````

代码块内的行内 HTML

代码块中可以直接写 HTML 标签，不会被渲染，会以纯文本显示。

示例：

1
2
3
<div class="container">
  <p>Hello</p>
</div>

效果：

1
2
3
<div class="container">
  <p>Hello</p>
</div>

小结：代码相关的语法是技术文章中最高频使用的功能。日常写作推荐优先使用围栏代码块并指定语言以获得语法高亮；偶尔在句子中引用函数名或命令时使用行内代码；缩进代码块的使用场景比较有限，仅在无需语法高亮的纯文本场景下偶尔使用。

2026/05/10

008 链接（links）

链接是 Markdown 中将文本与 URL 关联的核心语法，有三种常用写法：行内链接、引用式链接和自动链接。

行内链接（Inline Links）

将链接文本放在方括号 [] 中，紧接着在圆括号 () 中放入 URL。在 URL 后还可以用双引号添加可选的标题（鼠标悬停时显示）。

示例：

1
这是一个 [Markdown 官方教程](https://www.markdownguide.org "悬停提示文字") 的链接。

效果：
这是一个 Markdown 官方教程 的链接。

引用式链接（Reference-style Links）

引用式链接将 URL 从正文中分离出来，适合同一 URL 多次引用、或需要集中管理链接的场景。写法分为两部分——正文中的标记和文档任意位置的定义。

示例：

1
2
3
4
推荐阅读 [GitHub Flavored Markdown][gfm] 和 [CommonMark][commonmark] 规范。

[gfm]: https://github.github.com/gfm/ "GFM 规范"
[commonmark]: https://commonmark.org/ "CommonMark 规范"

效果：
推荐阅读 GitHub Flavored Markdown 和 CommonMark 规范。

网址和邮箱自动链接（Autolinks）

用尖括号 <> 包裹 URL 或邮箱地址，即可快速创建可点击链接。

示例：

1
2
访问 <https://www.example.com> 了解更多。
联系我们：<support@example.com>

效果：
访问 https://www.example.com 了解更多。
联系我们：support@example.com

用链接引用图片

将图片语法嵌套在链接语法中，即可实现”点击图片跳转链接”的效果（详见图片章节）。

[![alt](图片地址)](目标链接)

小结：日常写作中，行内链接最常用也最直观。引用式链接适合需要多次引用同一 URL 或长文档中集中维护链接的场景。自动链接简洁方便，适合快速引用网址和邮箱。

2026/05/11

009 图片（images）

图片语法与链接语法类似，只需在前方加一个感叹号 !。Markdown 中图片不会真正”嵌入”文档，而是通过 URL 引用外部资源。

基本图片

![替代文本](图片地址 "可选标题")——方括号中是替代文本（图片加载失败时显示），圆括号中是图片地址。

示例：

1
![这是一只猫](https://placekitten.com/200/300 "一只可爱的猫咪")

效果（展示图片）：

这是一只猫

带链接的图片

将图片语法嵌入到链接的方括号中，即可创建可点击的图片链接。

示例：

1
[![GitHub 徽标](https://github.githubassets.com/favicons/favicon.png)](https://github.com)
引用式图片

与引用式链接类似，图片也可以用引用式写法集中管理图片地址。

示例：

1
2
3
![猫的图片][cat]

[cat]: https://placekitten.com/300/200 "猫"

小结：图片语法本质是链接语法的扩展（多了 !）。实际使用中，如果图片托管在 CDN 或图床上，直接使用行内图片即可；如果同一图片重复引用，使用引用式图片更方便维护。

2026/05/12

010 表格（tables）

表格是 GitHub Flavored Markdown（GFM）的重要扩展，通过管道符 | 和短横线 - 构建表格结构。

基本表格

使用 | 分隔列，使用短横线 - 定义表头与表体的分界线。

示例：

1
2
3
4
5
| 姓名 | 年龄 | 城市 |
| ---- | ---- | ---- |
| 张三 | 25   | 北京 |
| 李四 | 30   | 上海 |
| 王五 | 28   | 广州 |

效果：

姓名 年龄 城市
张三 25 北京
李四 30 上海
王五 28 广州
表格对齐

在分隔线的左侧、右侧或两侧添加冒号 : 控制列的对齐方式。

  • :--- 左对齐
  • :---: 居中对齐
  • ---: 右对齐

示例：

1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容   | 内容     | 内容   |
| 较长内容 | 较长内容 | 较长内容 |

效果：

左对齐 居中对齐 右对齐
内容 内容 内容
较长内容 较长内容 较长内容
表格内其他格式

表格中可以使用行内格式（粗体、斜体、行内代码、链接等），但不能使用标题、代码块、列表等块级元素。

示例：

1
2
3
4
5
| 功能 | 语法 | 说明 |
| ---- | ---- | ---- |
| **粗体** | `**text**` | 加粗文本 |
| *斜体* | `*text*` | 斜体文本 |
| [链接](https://example.com) | `[text](url)` | 外部链接 |

效果：

功能 语法 说明
粗体 **text** 加粗文本
斜体 *text* 斜体文本
链接 [text](url) 外部链接

小结：表格是展示结构化数据的利器。实际写作中，无需刻意对齐管道符 | 和空格，渲染效果相同。建议保持源码整齐以方便后期维护。

2026/05/13

011 转义字符（escaping characters）

Markdown 中一些字符有特殊含义（如 * 表示斜体、` 表示代码）。如果要在正文中显示这些字符本身，需要在前面加反斜杠 \ 进行转义。

可转义字符

以下字符可以通过反斜杠转义来显示字面值：

字符 含义 转义写法
\ 反斜杠 \\
` 反引号 \`
* 星号 \*
_ 下划线 \_
{} 花括号 \{\}
[] 方括号 \[\]
() 圆括号 \(\)
# 井号 \#
+ 加号 \+
- 减号 \-
. 句点 \.
! 感叹号 \!
` ` 管道符 |
转义示例
1
2
3
4
5
\*这不是斜体\*

\# 这不是标题

这才是 \`行内代码\` 中的反引号

效果：

*这不是斜体*

# 这不是标题

这才是 `行内代码` 中的反引号

HTML 实体替代方案

部分场景下，使用 HTML 实体（entity）比反斜杠转义更灵活。例如 &lt; 表示 <，&amp; 表示 &。

实体 显示
&lt; <
&gt; >
&amp; &
&copy; ©

小结：转义字符的核心用途是在不触发 Markdown 语法的情况下显示字面字符。日常写作中遇到 *、_、# 等符号误触发格式时，第一时间想到在前面加 \。

2026/05/14

012 分隔线（horizontal rules）

分隔线用于在内容之间创建视觉上的分隔。有三种等价的写法，各自使用 3 个或以上的 -、* 或 _，可以带空格。

示例：

1
2
3
4
5
这是上一段内容。

---

这是下一段内容。

效果（显示为一条横线）：

这是上一段内容。

这是下一段内容。

所有等价写法：

1
2
3
4
5
6
7
---
***
___

* * *

- - - -

注意：分隔线前后都应有空行，否则可能被解析为标题或加粗语法。

小结：分隔线语法简单实用，建议统一使用 ---（三条短横线）作为分隔线标记，前后各留一个空行。

2026/05/15

013 内嵌 HTML（raw HTML）

Markdown 设计的初衷之一是允许在文档中直接嵌入原始 HTML，实现 Markdown 本身不支持的排版效果。

行内 HTML

在段落中直接使用 HTML 标签：

示例：

1
这是一段 Markdown 文本，其中嵌入 <u>下划线</u> 和 <mark>高亮标记</mark>。

效果：
这是一段 Markdown 文本，其中嵌入 下划线 和 高亮标记。

块级 HTML

使用 <div>、<table> 等块级元素时，建议前后用空行隔开，且块内不要缩进。

示例：

1
2
3
4
5
6
<details>
<summary>点击展开详情</summary>

这里是折叠的内容，可以包含 **Markdown 格式**。

</details>

效果：

点击展开详情

这里是折叠的内容，可以包含 Markdown 格式。

HTML 内的 Markdown

HTML 块级标签内的 Markdown 默认不会被解析。若需要在 HTML 块中继续使用 Markdown，可以在标签上添加 markdown="1" 属性（部分渲染器支持）。

常用 HTML 补充场景

Markdown 本身不提供以下功能，可以搭配 HTML 实现：

  • <kbd>Ctrl</kbd> + <kbd>C</kbd> → Ctrl + C（键盘按键样式）
  • <sup>上标</sup> 和 <sub>下标</sub>（上下标）
  • <center>居中文字</center>（文字居中）
  • <span style="color:red">红色文字</span>（文字颜色，部分平台可能过滤）

小结：内嵌 HTML 是 Markdown 的有力补充，适合实现复杂排版。但过度使用 HTML 会降低文档的可读性和可移植性，尽量优先使用纯 Markdown 语法。

2026/05/16

014 脚注（footnotes）

脚注允许在页面底部添加注释或引用，正文中用标记链接到脚注内容。这是部分 Markdown 编辑器支持的扩展语法（如 Typora、VS Code 预览、Hexo 等）。

基本用法

在正文中用 [^标识符] 标记脚注位置，在文档任意位置用 [^标识符]: 内容 定义脚注内容。

示例：

1
2
3
这是一个带脚注的句子。[^1]

[^1]: 这是脚注的内容，会显示在页面底部。

效果（脚注显示在底部）：
这是一个带脚注的句子。^1

多段落脚注

脚注内部可以包含多个段落，后续段落需要缩进 4 个空格。

示例：

1
2
3
4
5
这是带长脚注的文本。[^note]

[^note]: 这是第一段脚注内容。

    这是第二段脚注内容，需要缩进 4 个空格。
脚注内嵌格式

脚注中可以使用行内格式（粗体、斜体、链接、行内代码等）。

示例：

1
2
3
Markdown 由 John Gruber 发明。[^gruber]

[^gruber]: 参见 [Daring Fireball](https://daringfireball.net/projects/markdown/) 网站上的原始说明。

小结：脚注适合学术引用、额外说明等场景。需要注意并非所有平台都支持脚注，发布前应确认渲染效果。

2026/05/17

015 数学公式（LaTeX math）

部分 Markdown 编辑器（如 Typora、VS Code、Hexo + MathJax 等）支持 LaTeX 数学公式渲染，分为行内公式和块级公式。

行内公式

用单个 $ 包裹公式，嵌入在段落中。

示例：

1
勾股定理的表达式为 $a^2 + b^2 = c^2$，其中 $a$ 和 $b$ 是直角边。

效果：
勾股定理的表达式为 $a^2 + b^2 = c^2$，其中 $a$ 和 $b$ 是直角边。

块级公式

用两个 $$ 包裹公式，公式独占一行并居中显示。

示例：

1
2
3
$$
\frac{d}{dx}e^x = e^x
$$

效果：

$$
\frac{d}{dx}e^x = e^x
$$

常用 LaTeX 语法速查
语法 效果 说明
x^2 $x^2$ 上标
x_i $x_i$ 下标
\frac{a}{b} $\frac{a}{b}$ 分数
\sqrt{x} $\sqrt{x}$ 平方根
\sum_{i=1}^{n} $\sum_{i=1}^{n}$ 求和
\int_{a}^{b} $\int_{a}^{b}$ 积分
\infty $\infty$ 无穷大
\alpha, \beta, \gamma $\alpha, \beta, \gamma$ 希腊字母
\times, \div $\times, \div$ 乘除符号
\leq, \geq $\leq, \geq$ 小于等于 / 大于等于
\neq $\neq$ 不等于
\cdot $\cdot$ 点乘
矩阵示例
1
2
3
4
5
6
7
$$
\begin{bmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{bmatrix}
$$

效果：

$$
\begin{bmatrix}
1 & 2 & 3 \
4 & 5 & 6 \
7 & 8 & 9
\end{bmatrix}
$$

小结：数学公式是学术类 Markdown 写作的核心需求。使用 $...$ 嵌入行内公式，使用 $$...$$ 展示块级公式，LaTeX 语法全面且表达能力强。发布前确认目标平台是否支持 MathJax 或 KaTeX 渲染。

2026/05/18

016 目录（TOC / table of contents）

部分 Markdown 编辑器会根据标题自动生成目录，也可以用特定语法手动插入。

自动生成

常见标记 [TOC] 或 [toc]（由渲染器或静态站点生成器支持，如 Typora、Hexo 等）。

示例：

1
[TOC]
手动编写

手动构建目录时，利用 Markdown 的链接语法，将目录项链接到对应标题锚点。

标题锚点转换规则：标题文字转为小写、空格替换为 -、移除标点符号。

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
- [标题](#001-标题headers)
- [段落](#002-段落paragraphs)
- [换行](#003-换行line-breaks)
- [强调](#004-强调emphasis)
- [引用](#005-引用quotes)
- [列表](#006-列表lists)
- [代码](#007-代码code)
- [链接](#008-链接links)
- [图片](#009-图片images)
- [表格](#010-表格tables)
- [转义字符](#011-转义字符escaping-characters)
- [分隔线](#012-分隔线horizontal-rules)
- [内嵌 HTML](#013-内嵌-htmlraw-html)
- [脚注](#014-脚注footnotes)
- [数学公式](#015-数学公式latex-math)
- [目录](#016-目录toc--table-of-contents)
- [删除线与高亮标记](#017-删除线strikethrough--高亮标记highlight)

效果：

2026/05/18

017 删除线（strikethrough）& 高亮标记（highlight）

删除线

在文本前后各添加两个波浪线 ~~ 即可创建删除线效果，表示已删除或不正确的内容。这是 GFM 扩展语法。

示例：

1
~~这段内容已过时~~

效果：
这段内容已过时

高亮标记

部分编辑器（如 Typora、Hexo 等）支持用两个等号 == 包裹文本实现高亮效果。

示例：

1
这里有一句 ==非常重要== 的话。

效果：
这里有一句 ==非常重要== 的话。

定义列表（Definition Lists）

部分 Markdown 扩展支持定义列表，用 : 开头定义术语的解释。

示例：

1
2
3
4
5
Markdown
: 一种轻量级标记语言，由 John Gruber 于 2004 年创建。

HTML
: 超文本标记语言，用于创建网页的标准语言。
Emoji（表情符号）

GFM 支持通过短代码插入 emoji。常见的有：

短代码 表情
:smile: :smile:
:+1: :+1:
:heart: :heart:
:tada: :tada:
:warning: :warning:
:rocket: :rocket:

示例：

1
项目发布啦 :tada: 感谢所有人的贡献 :heart:

效果：
项目发布啦 :tada: 感谢所有人的贡献 :heart:

小结：GFM 扩展语法为 Markdown 增添了更多表现力，删除线和 Emoji 是最常用的扩展，几乎所有主流 Markdown 编辑器都支持它们。高亮标记和定义列表的支持范围则略窄，使用前需确认目标平台兼容性。

全文总结：至此，Markdown 的核心语法和常用扩展已全部介绍完毕。从基础的标题、段落、强调，到代码块、表格、链接图片，再到数学公式和脚注等高级功能，你已经掌握了编写高质量 Markdown 文档所需的全部知识。建议在实际写作中反复练习，逐渐形成自己的写作风格和习惯。

许可协议

本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。

分享文章

快来参与讨论吧~