一级标题#

三级标题#

3.2 段落与换行#

• 段落：由一行或多行文字组成，段落之间用空行分隔。
• 换行：在行尾添加两个空格，然后回车，即可实现换行（有些渲染器也支持直接使用 <br> 标签）。

1
这是第一段。
2
这是第一段内的换行（行尾有两个空格）。
3

4
这是第二段。

效果：

这是第一段。
这是第一段内的换行（行尾有两个空格）。

这是第二段。

3.3 强调#

注意：某些渲染器要求符号与文字之间不能有空格，例如 * 斜体* 不会生效，应写作 *斜体*。

3.4 列表#

1
- 苹果
2
- 香蕉
3
- 橙子
4

5
* 苹果
6
* 香蕉
7
* 橙子

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

1
- 水果
2
  - 苹果
3
  - 香蕉
4
- 蔬菜
5
  1. 胡萝卜
6
  2. 西兰花

3.5 链接#

1
[必应](https://www.bing.com)
2
[带标题的链接](https://www.bing.com "访问必应")

1
[百度][baidu] 和 [必应][bing] 都是搜索引擎。
2

3
[baidu]: https://www.baidu.com
4
[bing]: https://www.bing.com

1
<https://example.com>
2
<email@example.com>

3.6 图片#

图片语法与链接类似，前面加一个感叹号：

1
![替代文字](图片URL "可选标题")

例如：

1
![Markdown 徽章](https://markdown-here.com/img/icon256.png)

效果：

图片也支持参考式写法。

3.7 引用#

使用 > 表示引用，可以嵌套：

1
> 这是一段引用。
2
>
3
> 可以跨越多行。
4
>> 嵌套引用。

效果：

这是一段引用。

可以跨越多行。

嵌套引用。

3.8 代码#

1
请执行 `npm install` 命令。

1
```python
2
def hello():
3
    print("Hello, Markdown!")
4
```

1
def hello():
2
    print("Hello, Markdown!")

3.9 水平线#

使用三个或更多的 -、* 或 _：

1
---
2
***
3
___

效果：

3.10 表格#

用 | 分隔单元格，用 - 分隔表头与表体，可用 : 设置对齐方式：

1
| 左对齐 | 居中对齐 | 右对齐 |
2
|:-------|:--------:|-------:|
3
| 苹果   | 香蕉     | 橙子   |
4
| 猫     | 狗       | 兔子   |

效果：

3.11 任务列表#

在 GitHub Flavored Markdown (GFM) 中支持任务列表：

1
- [x] 已完成任务
2
- [ ] 未完成任务

效果：

• 已完成任务
• 未完成任务

3.12 脚注#

某些 Markdown 处理器（如 Pandoc、GitHub 部分支持）支持脚注：

1
这是一段文字[^1]。
2

3
[^1]: 这是脚注的解释。

效果：
这是一段文字¹。

注意：脚注的渲染效果依赖具体平台。

3.13 定义列表#

部分扩展语法支持定义列表：

1
Markdown
2
:   一种轻量级标记语言。
3

4
HTML
5
:   超文本标记语言。

效果（取决于渲染器）：

Markdown : 一种轻量级标记语言。

HTML : 超文本标记语言。

3.14 内嵌 HTML#

Markdown 兼容 HTML，当 Markdown 语法无法满足需求时，可以直接使用 HTML 标签：

1
这是一段 <span style="color: red;">红色文字</span>。
2

3
<details>
4
  <summary>点击展开</summary>
5
  这里是隐藏的内容。
6
</details>

效果：

这是一段 红色文字。

7.1 YAML Front Matter#

许多静态网站生成器（如 Jekyll、Hugo、Hexo）和 Markdown 编辑器支持在文件开头添加 YAML 格式的元数据，称为 Front Matter。它通常用 --- 包裹，用于定义标题、日期、分类、标签等信息。

1
---
2
title: 我的文章
3
date: 2025-03-15
4
categories: 技术
5
tags: [Markdown, 教程]
6
---
7

8
# 正文开始...

Front Matter 在渲染时会被解析，但不会显示在正文中。

7.2 数学公式#

通过 LaTeX 语法，许多 Markdown 渲染器（如 Typora、Jupyter、GitHub 的 MathJax 支持）可以显示数学公式。

• 行内公式：用单个美元符号 $...$ 包裹
  $E = mc^2$ 效果：$E = mc^2$
• 块级公式：用双美元符号 $$...$$ 包裹

1
$$
2
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
3
$$

效果：

7.3 图表和流程图（Mermaid）#

Mermaid 是一种基于文本的图表绘制工具，许多 Markdown 编辑器（如 Typora、GitHub）支持嵌入 Mermaid 代码块。

1
```mermaid
2
graph TD;
3
    A-->B;
4
    A-->C;
5
    B-->D;
6
    C-->D;
7
```

效果（需渲染器支持）：

1
graph TD;
2
    A-->B;
3
    A-->C;
4
    B-->D;
5
    C-->D;

7.4 交叉引用与目录#

一些扩展语法允许插入目录或交叉引用标题。例如在 Markdown 中，可以使用 [链接文本](#标题标识符) 的方式链接到同一文档的标题。标题标识符通常是将标题转换为小写、用连字符连接（如 ## 我的标题 的标识符为 #我的标题）。

在支持自动目录的编辑器（如 Typora）中，可以插入 [TOC] 生成目录。

1
[TOC]
2

3
## 第一节
4
## 第二节

7.5 内联属性#

某些 Markdown 变体（如 Kramdown）允许为元素添加属性，例如为图片指定宽度：

1
![图片](image.png){: width="50%"}

这并非标准语法，使用时需确认渲染器支持。

8.1 静态网站生成器#

Markdown 是静态网站生成器（如 Hugo、Jekyll、Next.js、VuePress）的核心内容格式。你可以用 Markdown 写文章，生成器会自动将其转换为 HTML，并套用主题。

8.2 文档生成工具#

• MkDocs：专为项目文档设计，使用 Markdown 编写，支持主题和插件。
• Docusaurus：Facebook 开源，适合构建文档网站，支持 Markdown 和 MDX（在 Markdown 中嵌入 JSX）。
• GitBook：在线文档平台，支持 Markdown 导入。

8.3 笔记应用#

• Obsidian：基于本地 Markdown 文件的双向链接笔记工具，知识库构建神器。
• Roam Research、Logseq：类似理念，支持 Markdown 格式。
• Notion：虽使用自己的块编辑器，但支持 Markdown 快捷输入（如 # 标题、* 列表等）。

8.4 转换工具（Pandoc）#

Pandoc 是一个强大的文档转换工具，可以在 Markdown、HTML、PDF、Word、LaTeX 等数十种格式之间相互转换。例如：

1
pandoc input.md -o output.pdf

通过 Pandoc，你可以利用 Markdown 编写，然后输出为出版级 PDF 或 Word 文档。

Q1: Markdown 中如何添加注释？#

A: Markdown 没有内置注释语法，但可以使用 HTML 注释 <!-- 注释内容 -->，它在渲染时会被忽略。

Q2: 如何在表格中换行？#

A: 可以在单元格中使用 HTML 的 <br> 标签。例如：

1
| 列1 | 列2 |
2
|-----|-----|
3
| 第一行<br>第二行 | 内容 |

Q3: 如何强制换行而不开始新段落？#

A: 在行尾添加两个空格再回车。

Q4: 不同平台的 Markdown 语法有差异，如何保证兼容性？#

A: 尽量使用标准 CommonMark 语法，避免依赖特定扩展。如果必须使用扩展，可在文档开头注明所需的渲染器。

Q5: 如何在 Markdown 中嵌入视频？#

A: Markdown 本身不支持嵌入视频，但可以使用 HTML 的 <video> 标签或嵌入 iframe（如 YouTube 嵌入代码）。

1
<video src="video.mp4" controls></video>

Q6: 有没有 Markdown 的语法检查工具？#

A: 有，例如 markdownlint（VS Code 插件）可以检查并修复语法问题，保持风格一致。