Markdown 完全指南：从入门到精通

Markdown 是一种轻量级标记语言，用户可使用纯文本编辑器来排版文档，最终通过 Markdown 引擎将文档转换为所需格式（比如 HTML、PDF 等）。本文将全面介绍 Markdown 的基础语法和扩展语法，帮助你快速掌握这门实用的标记语言。

标题

要创建标题，请在单词或短语前添加井号 (#)。井号的数量应与标题级别相对应。

备用语法

或者，在文本下方的行中，添加任意数量的 == 字符以表示一级标题，或 -- 字符以表示二级标题。

一级标题
===

二级标题
---

段落

要创建段落，请使用空白行将一行或多行文本进行分隔。

第一段内容

第二段内容

换行

在一行的末尾添加两个或多个空格，然后按回车键，即可创建一个换行。

强调

粗体

要加粗文本，请在单词或短语的前后各添加两个星号（asterisks）或下划线（underscores）。

**这是粗体文本**
__这也是粗体文本__

斜体

要用斜体显示文本，请在单词或短语前后各添加一个星号或下划线。

*这是斜体文本*
_这也是斜体文本_

粗体和斜体

要同时用粗体和斜体突出显示文本，请在单词或短语的前后各添加三个星号或下划线。

***这是粗斜体文本***
___这也是粗斜体文本___

引用

要创建块引用，请在段落前添加一个 > 符号。

> 这是一段引用文本

嵌套引用

块引用可以嵌套。在要嵌套的引用前添加一个 >> 符号。

> 外层引用
>> 嵌套引用

列表

有序列表

要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。

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

无序列表

要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+)。

- 第一项
- 第二项
- 第三项

在列表中嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符。

1. 第一项
    这是第一项的说明文字
2. 第二项
    > 这是第二项中的引用

代码

行内代码

要将单词或短语表示为代码，请将其包裹在反引号 (`) 中。

使用 `print()` 函数输出内容

代码块

要创建代码块，请将代码块的每一行缩进至少四个空格或一个制表符，或者使用围栏式代码块（推荐）。

```python
def hello():
    print("Hello, World!")
```

分隔线

要创建分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容。

***

---

___

链接

普通链接

链接文本放在中括号内，链接地址放在后面的括号中。

[链滴社区](https://ld246.com)

带标题的链接

链接标题是当鼠标悬停在链接上时会出现的文字，放在链接地址后面的引号中。

[链滴社区](https://ld246.com "访问链滴社区")

网址和 Email 地址

使用尖括号可以方便地将 URL 和 Email 地址变成可点击的链接。

<https://ld246.com>
<example@email.com>

图片

要添加图像，请使用感叹号 (!)，然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。

![链滴 Logo](https://ld246.com/logo.png "链滴")

带链接的图片

给图片增加链接，请将图像的 Markdown 括在方括号中，然后将链接添加在圆括号中。

[![链滴 Logo](https://ld246.com/logo.png)](https://ld246.com)

转义字符

要显示原本用于格式化 Markdown 文档的字符，请在字符前面添加反斜杠 ()。

\* 这不是斜体 \*

扩展语法

表格

要添加表，请使用三个或多个连字符 (---) 创建每列的标题，并使用管道符 (|) 分隔每列。

| 表头1 | 表头2 |
|-------|-------|
| 内容1 | 内容2 |
| 内容3 | 内容4 |

代码围栏

使用三个反引号 (```) 或三个波浪号 (~~~) 来创建代码块。

```json
{
  "name": "示例",
  "version": "1.0"
}
```

脚注

脚注使您可以添加注释和参考，而不会使文档正文混乱。

这是一个脚注的示例[^1]

[^1]: 这是脚注内容

标题编号

许多 Markdown 处理器支持标题的自定义 ID，使您可以直接链接到标题。

### 标题 {#custom-id}

定义列表

一些 Markdown 处理器允许您创建术语及其对应定义的定义列表。

术语
: 定义内容

删除线

在单词前后使用两个波浪号 (~~) 来表示删除线。

~~这是被删除的文本~~

任务列表

任务列表使您可以创建带有复选框的项目列表。

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

表情符号

有两种方法可以将表情符号添加到 Markdown 文档中：将表情符号复制并粘贴到 Markdown 格式的文本中，或者键入 emoji shortcode。

:joy:
:heart:

高亮

这是受支持的扩展语法，用于突出显示文本。

==这是高亮文本==

下标和上标

H~2~O  (下标)
X^2^   (上标)

常用 Markdown 应用程序

总结

Markdown 的语法简洁明了，学习曲线平缓，是写作、文档编写、笔记记录的理想选择。掌握基础语法后，你可以在任何支持 Markdown 的平台上高效地进行内容创作。对于需要更多功能的场景，可以使用扩展语法来实现表格、脚注、任务列表等高级功能。