一、前言
- 本文是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通过底线实现纯文本的标题化，即在标题文字下添加一个或多个“
=”（一级标题）或“-”（二级标题）。
- 类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个“
*”或“_”时，文段变为斜体且加粗
- 前后各1个“
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使用技巧，本文将不断更新。
-
这是一条脚注示例。 ↩
网友评论