Markdown 基本语法指北

几乎所有现代的博客平台和静态网站生成器都完美支持 Markdown。它能让我们在纯文本环境下专注于内容创作，而无需被复杂的排版工具打断思路。

以下是日常写作中最常用的 Markdown 基本语法。

1. 标题 (Headings)

要在文档中创建标题，请在单词或短语前面添加井号 (#)。# 的数量代表了标题的级别。为了兼容性，请务必在 # 和标题文字之间保留一个空格。

1
2
3
4
5
6


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

段落： 创建段落非常简单，只需要使用一或多个空白行将连续的文本分隔开即可。不要用空格（spaces）或制表符（tabs）缩进段落。

换行： 如果你想在段落内强行换行（创建 <br>），请在这一行的末尾添加两个或多个空格，然后按回车键。

通过添加星号或下划线，可以轻松实现加粗和斜体效果。

要在段落前添加块引用，请在段落的第一行或者每一行前面添加一个 > 符号。引用不仅支持多段落，还可以嵌套其他 Markdown 元素。

1
2
3
4


> 这是一段引用文本。
> 
> > 这是一个嵌套的引用。
> > 里面还可以使用 **加粗** 等其他语法。

你可以将项目组织成有序列表或无序列表。

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

1
2
3


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

无序列表： 在每个列表项前添加破折号 (-)、星号 (*) 或加号 (+)。建议统一使用 -。

1
2
3


- 苹果
- 橘子
- 香蕉

行内代码： 如果要把句子中的某个单词或短语标记为代码，请将其包裹在反引号 ( \ `) 中。

代码块： 要创建多行代码块，请将代码包裹在三个反引号 (```) 中。在第一排的反引号后面加上编程语言的名称，就可以实现代码高亮。

1
2


def greet(name):
    print(f"Hello, {name}!")

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

1

---

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

如果想直接显示网址并使其可点击，可以用尖括号将网址括起来：<https://example.com>。

插入图片的语法和链接非常相似，只是前面多了一个感叹号 (!)。

1

![美丽的风景图](https://markdown.com.cn/assets/img/philly-magic-garden.9c0b4415.jpg "Magic Gardens")

美丽的风景图

如果你需要显示原本用于格式化 Markdown 文档的字符（比如你不希望 # 变成标题），可以在该字符前面添加反斜杠 (\) 来转义。

1

\* 这不是一个无序列表项，而是一个普通的星号。