Markdown 完全指南

Markdown 是一种轻量级的标记语言，广泛应用于编写文档、博客、README 文件等。由于其简单的语法和良好的可读性，Markdown 已成为技术人员和写作者常用的文档撰写工具之一。本教程将介绍 Markdown 的常用语法、进阶用法及各种扩展功能，帮助你快速掌握这项技能。

1. 标题

Markdown 使用 # 符号表示标题，# 的数量决定标题的级别，从一级标题到六级标题不等。

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

2. 段落与换行

直接输入文字即为段落，段落之间需要空行隔开。行内换行需要在行尾加两个空格。

这是第一段。

这是第二段。
这是同一段中的新行。

3. 强调

Markdown 支持文本加粗、斜体及同时加粗斜体。

_斜体_
**加粗**
**_加粗并斜体_**

效果：

斜体
加粗
*加粗并斜体*

4. 引用

使用 > 符号可以创建引用块，并且可以嵌套。

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

5. 列表

无序列表

无序列表使用 -、+ 或 * 作为列表标记。

- 项目一
- 项目二
  - 子项目

效果：

• 项目一
• 项目二
  • 子项目

有序列表

有序列表使用数字加 . 来表示。

1. 项目一
2. 项目二
   1. 子项目

效果：

1. 项目一
2. 项目二
   1. 子项目

6. 链接与图片

使用 [文本](URL "文本") 语法创建超链接，使用 ![图片描述](图片地址) 插入图片。

[Google](https://www.google.com "Google")
![Markdown Logo](https://markdown-here.com/img/icon256.png)

7. 代码块

行内代码使用反引号 ````，多行代码使用三个反引号包围，并且可以指定代码语言以启用语法高亮。

def hello_world():
    print("Hello, World!")

8. 表格

使用 | 和 - 创建表格，并通过 : 控制对齐方式。

| 名字 | 年龄 | 性别 |
| :--- | :--: | ---: |
| 张三 |  25  |   男 |
| 李四 |  30  |   女 |

效果：

名字	年龄	性别
张三	25	男
李四	30	女

9. 水平分割线

使用 ---、*** 或 ___ 创建分割线。

---

效果：

---

10. 转义字符

使用反斜杠 \ 来转义 Markdown 特殊符号。

\*这是不被解析的星号\*

效果：

这是不被解析的星号

11. 注脚

Markdown 支持注脚功能，通过 [^注脚] 来实现，注脚内容放在文档底部。

这是一个带注脚的例子[^1]。

[^1]: 这是注脚的内容。

效果：

这是一个带注脚的例子^1。

12. 任务列表

Markdown 中可以创建任务列表，常用于跟踪任务状态。

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

13. 内部链接（锚点链接）

可以通过 # 创建文档内部的跳转链接，常用于创建目录或快速导航。

[跳转到高级用法](#高阶用法 "跳转到高级用法")

14. LaTeX 公式

Markdown 支持 LaTeX 数学公式，可以通过 $ 或 $$ 来包围公式内容。

这是行内公式：$E=mc^2$

这是块级公式：

$$
\sum_{i=1}^n a_i^2
$$

效果：

这是行内公式：

这是块级公式：

$$
\sum_{i=1}^n a_i^2
$$

15. Mermaid 流程图

借助 Mermaid，可以在 Markdown 中创建流程图或时序图等可视化内容。

/Users/xu/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/wxid_neghhff72jo721_cb5c/temp/InputTemp/b699a258-8d44-4dbb-8c7c-ea70f37fa743.png<pre class="mermaid">graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;</pre>

16. 折叠内容

使用 <details> 和 <summary> 标签来实现可折叠的内容。

<details>
  <summary>点击展开</summary>
  这是隐藏的内容。
</details>

效果：

点击展开

这是隐藏的内容。

结语

Markdown 的简洁、灵活和易读性，使其成为撰写文档的首选工具。通过本教程，你不仅能掌握 Markdown 的基本语法，还能利用其高级功能扩展文档的可读性和功能性。无论是编写博客、项目文档，还是生成结构复杂的技术手册，Markdown 都能够帮助你轻松完成任务。希望本教程对你有所帮助，助你在文档编写中更高效地应用 Markdown。