markdown语法 – flechazo's blog

2026/04/21

001 标题（headers）

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

 # 一级标题
 ## 二级标题
 ### 三级标题
 #### 四级标题
 ##### 五级标题
 ###### 六级标题

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

2026/04/22

002 段落（paragraphs）

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

 这是一个段落。
 
 这是一个段落。

效果：

这是一个段落。

2026/04/23

003 换行（line breaks）

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

 markdown语法-换行   
 新的一行。

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

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

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

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

2026/04/26

004 强调（emphasis）

粗体

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

 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）。要斜体突出单词的中间部分，请在字母前后各添加一个星号，中间不要带空格。\ 示例：

 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

粗体和斜体

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

 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）

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

 > 这是一个引用。

效果：

这是一个引用。

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

> 这是一个引用。
>   
> 这是第二段引用。

效果：

这是一个引用。

这是第二段引用。

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

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

效果：

这是一个引用。

这是一个嵌套的引用。

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

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

效果：

这是一个引用。

这是一个列表项。

这是另一个列表项。

2026/05/03

006 列表（lists）

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

无序列表

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

- 列表项一
- 列表项二
- 列表项三

效果：

列表项一
列表项二
列表项三

有序列表

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

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

效果：

第一步
第二步
第三步

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

1. 第一步
1. 第二步
1. 第三步

嵌套列表

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

1. 第一项
   - 嵌套无序项
   - 另一个嵌套项
2. 第二项
   1. 嵌套有序项
   2. 另一个嵌套项

效果：

第一项
- 嵌套无序项
- 另一个嵌套项
第二项
1. 嵌套有序项
2. 另一个嵌套项

任务列表（GFM 扩展）

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

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

效果：

已完成任务
未完成任务
待办事项

列表内嵌套其他元素

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

- 第一项

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

效果：

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

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

- 列表项
  > 这是一条引用

效果：

列表项这是一条引用

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

- 列表项
  - 子项

        code here

2026/05/06

007 代码（code）

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

行内代码（Inline Code）

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

示例：

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

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

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

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

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

围栏代码块（Fenced Code Blocks）

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

示例：\ “`markdown

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

“`

效果：

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

语法高亮（Syntax Highlighting）

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

示例：\ “`python

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

“`

效果（带语法颜色）：

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 个制表符也可以创建代码块。这种方式无法指定语言，不能语法高亮，适合只需要展示纯文本的场景。

示例：

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

效果：

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

代码块内转义反引号

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

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

```python
print("hello")
```

““

代码块内的行内 HTML

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

示例：

<div class="container">
  <p>Hello</p>
</div>

效果：

<div class="container">
  <p>Hello</p>
</div>

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

2026/05/10

008 链接（links）

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

行内链接（Inline Links）

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

示例：

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

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

引用式链接（Reference-style Links）

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

示例：

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

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

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

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

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

示例：

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

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

用链接引用图片

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

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

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

2026/05/11

009 图片（images）

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

基本图片

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

示例：

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

效果（展示图片）：

带链接的图片

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

示例：

[![GitHub 徽标](https://github.githubassets.com/favicons/favicon.png)](https://github.com)

引用式图片

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

示例：

![猫的图片][cat]

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

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

2026/05/12

010 表格（tables）

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

基本表格

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

示例：

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

效果：

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

表格对齐

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

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

示例：

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容   | 内容     | 内容   |
| 较长内容 | 较长内容 | 较长内容 |

效果：

左对齐	居中对齐	右对齐
内容	内容	内容
较长内容	较长内容	较长内容

表格内其他格式

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

示例：

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

效果：

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

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

2026/05/13

011 转义字符（escaping characters）

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

可转义字符

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

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

转义示例

\*这不是斜体\*

\# 这不是标题

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

效果：

*这不是斜体*

# 这不是标题

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

HTML 实体替代方案

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

实体	显示
`<`	<
`>`	>
`&`	&
`©`	©

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

2026/05/14

012 分隔线（horizontal rules）

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

示例：

这是上一段内容。

---

这是下一段内容。

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

这是上一段内容。

这是下一段内容。

所有等价写法：

---
***
___

* * *

- - - -

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

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

2026/05/15

013 内嵌 HTML（raw HTML）

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

行内 HTML

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

示例：

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

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

块级 HTML

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

示例：

<details>
<summary>点击展开详情</summary>

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

</details>

效果：

点击展开详情

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

</details>

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]

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

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

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

多段落脚注

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

示例：

这是带长脚注的文本。[^note]

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

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

脚注内嵌格式

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

示例：

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 数学公式渲染，分为行内公式和块级公式。

行内公式

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

示例：

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

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

块级公式

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

示例：

$$
\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$	点乘

矩阵示例

$$
\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 等）。

示例：

[TOC]

手动编写

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

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

示例：

- [标题](#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)

效果：

标题
段落
换行
强调
引用
列表
代码
链接
图片
表格
转义字符
分隔线
内嵌 HTML
脚注
数学公式
目录
删除线与高亮标记