一、前言

• 本文是Markdown语法的使用说明，意在为（尤其是简书平台）Markdown格式文章的撰写提供简明的索引，原文请参见Markdown语法说明。
• Markdown是书写的格式，通过符号将纯文本转变为不同的格式。Markdown语法范围之外的格式可通过HTML来实现，直接在页面内加标签即可（该方式简书支持得非常有限）。

二、基本语法

目录
1.段落和换行
2.标题
3.区块引用
4.列表
5.代码区块
6.分隔线
7.链接
8.强调
9.代码
10.图片
11.脚注

---

1. 段落和换行

• Markdown的段落由一个或多个连续的文本行组成，前后通过一个或多个空行进行分隔（“空行”内的空格、制表符（tab）不影响文段分隔的效果，看起来空就行）。
  ——假如格式显示不正确，试试在文本前后增加空行。
• 除回车换行的方式外，还可以通过“在段落内任意位置添加<br>或<br/>”或“通过区块引用（句子前添加符号“>`”）和列表的方式”进行“换行”。
  ——这种换行只是改变了文本显示的格式，并非标定段落的终止。

2.标题

• 支持类Setext和类atx两种形式
  • 类Setext通过底线实现纯文本的标题化，即在标题文字下添加一个或多个“=”（一级标题）或“-”（二级标题）。

范例：
一级标题
==

一级标题

• 类atx通过在行首插入1~6个“#”实现纯文本的一至六级标题化

范例：
“# H1”

H1

3. 区块引用

• 通过在文段前添加“>”符号实现区块引用

例如：
“>这样”

• 可以在文段首行前加1个“>”，也可以文段的每一行前面加1个“>”，效果一样
• 多个“>”可以实现多层引用
  例如：
  “>第一层
  >>第二层
  >>>第三层
  >
  >回到第一层”，效果如下：

第一层

第二层

第三层
……

回到第一层

4. 列表

• 无序列表通过在行首添加“* ”、“+ ”或“- ”来实现，效果是一样的。（这句话的格式就是这么来的）
  • 中途换符号的话，相当于重新开始了一个列表（能通过行间距看出不同）
  • 无序列表可以延伸出多个层级，层级间通过在符号前添加制表符（tab键）实现。
    - 简书支持级差间最多3个制表符（不同平台不一样），多了就会被打回原形，像这样。
• 有序列表通过在行首添加“(数字). ”来实现，目前序号的排列与数字无关，与缩进层级有关，系统会自动排序。
• 若不想被自动识别为列表，则符号后面不要加空格，或者在“.”前面添加“\”（简书需添加2个）。

5. 代码区块

• 每行缩进4个空格或1个制表符即可。简书里：1个tab=2个空格
• 代码区块持续到没有缩进的那一行为止

假如这是一行代码。

6.分割线

• 当具备3个以上的“*”、“-”或“_”，且无除空格之外的其他内容时，可自动生成分割线。
  • 符号之间可以有空格
  • 符号前不可有“>”或4个以上的空格，否则将优先转为引用或代码区块。

以下均可以生成分割线
***
- - -
*******

---

7. 链接

• Markdown支持行内式和参考式的链接
• 行内式的格式为：

[链接文字](http://…/ "Title(可写可不写)")

• 参考式的格式为：（简书不支持）

[链接文字][XXX]
[XXX] : http://……/ "Title(可写可不写)"

8. 强调

• 文段前后加上“*”或“_”可进行强调
  • 前后各1个“*”或“_”时，文段变为斜体
  • 前后各2个“*”或“_”时，文段变为加粗
  • 前后各3个“*”或“_”时，文段变为斜体且加粗

9. 代码

• 小段的代码标记，请在文段的前后用“`”进行标记。

10. 图片

• 图片的引用同样有行内式和参考式两种
• 图片引用的格式与链接几乎一致，只是在“[文字]”前增加了1个“!”，同时将地址换成图片地址即可。

行内式：[图片上传失败...(image-5aedfd-1522577049020)]
参考式：![文字][id]
       [id]: url/to/image  "title(可选)"

举个栗子

• 当然，编辑器自带图片插入功能的话，就不用这么麻烦了。

11. 脚注

• 脚注代码如下^[1]：

 使用：文字 [^num]
 脚注：  [^num]: 脚注内容（在文段末尾写上即可）

12.表格

• 表格可通过如下格式实现：

    标题1|标题2|标题3
    -|-|-
    内容1|内容2|内容3
  

• 效果如下：

标题1	标题2	标题3
内容1	内容2	内容3

x. 其他

• 如果输入网址，如https://www.jianshu.com/，则编辑器会自动将其转为链接。

---

三、尾声

本文对Markdown语法说明进行了提炼，意在简明好用，希望可以为大家的创作提供方便。
PS：若发现新的Markdown使用技巧，本文将不断更新。

---

1. 这是一条脚注示例。 ↩