Markdown是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。
千万不要被「标记」、「语言」吓到，Markdown的语法十分简单，常用的标记符号不超过十个，用于日常写作记录绰绰有余，不到半小时就能完全掌握。
就是这十个不到的标记符号，却能让人优雅地沉浸式记录，专注内容而不是纠结排版，达到「心中无尘，码字入神」的境界。
John Gruber, Markdown 的作者：
Markdown 格式的首要设计目标是更具可读性。 最初的想法是 Markdown 格式的文档应当以纯文本形式发布， 而不会看起来像被标签或格式说明所标记。 虽然 Markdown 的语法受到几种现有的文本到 HTML 转换工具的影响， 但 Markdown 语法的最大灵感来源是纯文本电子邮件的格式。
标题
从 h2 到 h6 的标题在每个级别上都加上一个 ＃
## h2 标题
### h3 标题
#### h4 标题
##### h5 标题
###### h6 标题
注释
<!-- 这是一段注释(和 HTML 兼容) -->
水平线/分隔线
(1)___ 3个连续的下划线
(2)--- 3个连续的破折号
(3)*** 3个连续的星号
效果：
强调（加粗、斜体、删除线等）
加粗
**渲染为粗体 1**
__渲染为粗体 2__
效果：
渲染为粗体 1
渲染为粗体 2
斜体
*我是斜体*
效果：
我是斜体
删除线
~~这段文本带有删除线。~~
效果：这段文本带有删除线。
段落
要创建段落，请使用空白行将一行或多行文本进行分隔。不要用空格（spaces）或制表符（ tabs）缩进段落。
引用
要创建块引用，请在段落前添加一个 > 符号。
> 1.xx
> 2.xxx
> 3.xxxxx
> 4.xxxxxxxxxxxxx
效果：
1.xx
2.xxx
3.xxxxx
4.xxxxxxxxxxxxx
块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号。
> Dorothy followed her through many of the beautiful rooms in her castle.
>
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
效果：
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
链接和图片
链接
基本链接
<https://gdhblog.com>
<gdhblog@outlook.com>
[龚东海的博客](https://gdhblog.com)
效果：
https://gdhblog.com
gdhblog@outlook.com
龚东海的博客
添加链接描述
将鼠标悬停在链接上，会有一行提示。
[龚东海的博客](https://gdhblog.com "我是这个链接的描述。")
效果：
龚东海的博客
图片
图片的语法与链接相似，但包含一个在前面的感叹号
效果：
列表
将多个条目组织成有序或无序列表。
无序列表
- First item（Type 1）
- Second item（Type 1）
- Third item（Type 1）
* First item（Type 2）
* Second item（Type 2）
* Third item（Type 2）
+ First item（Type 3）
+ Second item（Type 3）
+ Third item（Type 3）
效果：
- First item（Type 1）
- Second item（Type 1）
- Third item（Type 1）
- First item（Type 2）
- Second item（Type 2）
- Third item（Type 2）
- First item（Type 3）
- Second item（Type 3）
- Third item（Type 3）
搭配使用（缩进2个空格即可）
- 水果
- 苹果 # 横杠前面是2个空格
- 西瓜
- 樱桃
- 球类
- 篮球
- 足球
- 乒乓球
效果：
- 水果
- 苹果
- 西瓜
- 樱桃
- 球类
- 篮球
- 足球
- 乒乓球
有序列表
要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。
1. First item（Type 1）
2. Second item（Type 1）
3. Third item（Type 1）
1. First item（Type 2）
1. Second item（Type 2）
1. Third item（Type 2）
1. First item（Type 3）
6. Second item（Type 3）
100. Third item（Type 3）
效果：
- First item（Type 1）
- Second item（Type 1）
- Third item（Type 1）
- First item（Type 2）
- Second item（Type 2）
- Third item（Type 2）
- First item（Type 3）
- Second item（Type 3）
- Third item（Type 3）
代码语法
短代码/单词/短语
要将单词或短语表示为代码，请将其包裹在反引号 (`) 中。
`Javascript`
`Python`
`Dynamics CRM`
效果：JavascriptPythonDynamics CRM
代码块
使用 ``` 生成一段带有语言属性的代码块。
``` javascript
function Person(firstName, lastName){
this.firstName = firstName;
this.lastName = lastName;
}
var Saad = new Person("Saad", "Mousliki");
```
效果：
function Person(firstName, lastName){
this.firstName = firstName;
this.lastName = lastName;
}
var Saad = new Person("Saad", "Mousliki");
换行
在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行(<br>)
床前明月光，(这里有2个空格)
疑似地上霜。(这里有2个空格)
举头望明月，(这里有2个空格)
低头思故乡。(这里有2个空格)
效果：
床前明月光，
疑似地上霜。
举头望明月，
低头思故乡。
表格
要添加表，请使用三个或多个连字符（—）创建每列的标题，并使用管道（|）分隔每列。
表格的基本使用
| 序号 | 姓名 |
| --- | --- |
| 1 | 小明 |
| 2 | 小红 |
| 3 | 小李 |
效果：
| 序号 | 姓名 |
|---|---|
| 1 | 小明 |
| 2 | 小红 |
| 3 | 小李 |
使用连字符和管道创建表可能很麻烦。为了提高效率，可以尝试使用 Markdown Tables Generator图形界面构建表，然后将生成的 Markdown 格式的文本复制到文件中。
进阶使用
对齐
通过在标题行中的连字符的左侧，右侧或两侧添加冒号（:），将列中的文本对齐到左侧，右侧或中心
| 序号(左对齐) | 姓名(居中对齐) | 电话号码(右对齐) |
| :--- | :---: | ---: |
| 1 | 小明 | 12345678 |
| 2 | 小红 | 22344133 |
| 3 | 小李 | 98726666 |
效果：
| 序号(左对齐) | 姓名(居中对齐) | 电话号码(右对齐) |
|---|---|---|
| 1 | 小明 | 12345678 |
| 2 | 小红 | 22344133 |
| 3 | 小李 | 98726666 |
格式化表格中的文字
可以在表格中设置文本格式。例如，您可以添加链接，代码（仅反引号（`）中的单词或短语，而不是代码块）和强调。
不能添加标题，块引用，列表，水平规则，图像或HTML标签。
任务列表
要创建任务列表，请在任务列表项之前添加破折号-和方括号[ ]，并在[ ]前面加上空格。要选择一个复选框，请在方括号[x]之间添加 x 。
- [x] 完成家庭作业
- [] 煮饭
- [] 打扫房间卫生
- [] 阅读10分钟课外书
效果：
- 完成家庭作业
- 煮饭
- 打扫房间卫生
- 阅读10分钟课外书
脚注
脚注使你可以添加注释和参考，而不会使文档正文混乱。当你创建脚注时，会在添加脚注引用的位置出现带有链接的上标编号。
要创建脚注引用，请在方括号中添加插入符号和标识符 ([^1])。 标识符可以是数字或单词，但不能包含空格或制表符。 标识符仅将脚注引用与脚注本身相关联 - 在脚注输出中，脚注按顺序编号。
在中括号内使用插入符号和数字以及用冒号和文本来添加脚注内容 ([^1]：这是一段脚注)。 你不一定要在文档末尾添加脚注。可以将它们放在除列表，引用和表格等元素之外的任何位置。
九月九日忆山东兄弟[^1]
独在异乡为异客[^2] ，
每逢佳节倍思亲[^3] 。
遥知兄弟登高处[^4] ，
遍插茱萸少一人[^5] 。
效果：
《九月九日忆山东兄弟1》
独在异乡为异客2 ，
每逢佳节倍思亲3 。
遥知兄弟登高处4 ，
遍插茱萸少一人5 。