MarkDown常用语法及示例

MarkDown常用语法及示例

1.标题

在文字开头加上“#”，通过“#”数量表示几级标题。（一共只有1~6级标题，1级标题字体最大）,建议在井号后加一个空格，这是最标准的 Markdown 语法

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

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2.引用

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用，如：

>
> 区块引用
>> 嵌套引用

效果：

区块引用

嵌套引用

3.强调

斜体:将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

粗体:将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来，如:

>
*斜体*
**粗体**
_斜体_
__粗体__

效果：

>
斜体
粗体
斜体
粗体

4.列表

4.1无序列表:在文字开头添加(, +, and -)实现无序列表,但是要注意在(, +, and -)和文字之间需要添加空格，如：

>
- 无序列表
* 无序列表
+ 无序列表

效果：

>
* 无序列表
+ 无序列表
- 无序列表

4.2有序列表:使用数字后面跟上句号.还要有空格,如:

>
1. 第一项
2. 第二项

效果：

>
1. 第一项
2. 第二项

5.分隔线

在一行连续使用三个或以上_或*，如:

>
___
***

效果：

---

---

6.代码区块

6.1行内代码:将使用`内容`来标记,不是单引号而是左上角的ESC下面的`,如:

>
`int main() {
reutrn 0;
}`

效果：

>
int main() {
reutrn 0;
}

6.2代码段落:每一行前边加入4个空格或者一个tab可以标记,如:

>
int main() {
reutrn 0;
}

效果：

int main() {
reutrn 0;
}

7.表格

>
Markdown中的表格书写建议使用TableEditor插件，该插件具有较好的自适应性，会自动对齐，强迫症患者喜欢。首先需要用ctrl + shift + p打开这个功能（Table Editor: Enable for current syntax or Table Editor: Enable for current view or “Table Editor: Set table syntax … for current view”），然后就可以狂用tab来自动完成了

第一行的标题需要手动录入，然后在第二行开始输入|-之后，直接按Tab键，然后在第三行输入test1后直接Tab键…

效果：

item1	item2	item3
test1	test2	test3dfdfdsfsd
test4	test5	test6

表格后面最好空一行

8.链接

Markdown有两种链接方式：Inline以及Reference

8.1文字链接

>
Inline:
[baidu](http://baidu.com/ “http://baidu.com/” )1
Reference:
[baidu][1]
[1]:http://baidu.com/ “http://baidu.com/“[^bbb]

效果：

>
Inline:
baidu
Reference:
baidu

8.2图像链接

添加图片的形式和链接相似，只需在链接的基础上前方加一个!

>
Inline:
2
Reference:
![test1][1]
[1]:http://i1.tietuku.com/a632dc100fbf5a4b.png “Markdown”[^bbb]

效果：

Inline:

Reference:

8.3自动链接

使用尖括号<>包含住一段地址或者邮箱
\http://www.baidu.com\
\loulvlin@travelsky.com\

效果：

>
http://www.baidu.com
loulvlin@travelsky.com

9.转义字符

Markdown中的转义字符为\，可以转义的有：

\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

10.脚注

实现方式如下：

>
footnotetest[^Footnote]
>
[^Footnote]:Footnote_Text

效果：

footnotetest[^Footnote]

11.目录

需要安装MarkdownPreview插件，在最前面添加[TOC]可以自动生成目录

NOTICE:这种方式生成的目录在文档最上面，实用性不是很方便，如要在文档左侧生成目录，需要借助其它方法来实现，请参考Markdown左侧目录

12.段落与缩进

markdown中各段落之间需要一个空行进行分隔

半方大的空白 或 ，放在段首即可实现缩进
全方大的空白 或 ，放在段首即可实现缩进
不断行的空白格 或 ，放在段首即可实现缩进

例子：

放在段首即可实现缩进

  放在段首即可实现缩进

放在段首即可实现缩进

效果:

放在段首即可实现缩进

  放在段首即可实现缩进

放在段首即可实现缩进

---

1. ()括号中的第二部分(“”包着的内容)可以省略，功能是一样的
   [^bbb]:连接后面第二部分(“”包着的内容)可以省略，功能是一样的
   [^Footnote]:Footnote_Text ↩
2. ()括号中的第二部分(“”包着的内容)可以省略，功能是一样的
   [^bbb]:连接后面第二部分(“”包着的内容)可以省略，功能是一样的
   [^Footnote]:Footnote_Text ↩