Markdown语法总结

2017-11-25

1.斜体和粗体

代码：

1.*斜体*或_斜体_
2.**粗体**
3.***加粗斜体***
4.~~删除线~~

显示效果：

1.这是一段斜体
2.这是一段粗体
3.这是一段加粗斜体
4.~~这是一段删除线~~

2.分级标题

代码：

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

3.超链接

Markdown支持两种形式的链接语法：行内式和参考式两种形式，一般选择使用行内式更多一些。

3.1 行内式

语法说明：
[]里写链接文字，()写链接地址，()中的””中的文字可以为链接指定title属性，这个可加可不加。title属性的含义是可以实现鼠标悬停在链接上出现指定的title文字。其格式为：[链接文字](链接地址 "链接标题")这样的形式。()里的链接地址和链接标题之间有一个空格。

代码：

1 2	欢迎访问[村上秋水的却其顿小屋](http://blog.163.com/snowball_wang/) 欢迎访问[村上秋水的却其顿小屋](http://blog.163.com/snowball_wang/ "村上秋水的却其顿小屋")

显示效果：
欢迎访问村上秋水的却其顿小屋
欢迎访问村上秋水的却其顿小屋

3.2 参考式

参考式链接多用于学术论文，便于对链接进行统一处理。

语法说明：

参考式链接分为两部分，文字的写法[链接文字][链接标记]，在文本的任意位置添加[链接标记]: 链接地址 “链接标题”，链接地址与链接标题之间有一个空格。

也可以将链接文字作为链接标记：[链接文字][]，然后在文本的任意位置添加[链接文字]: 链接地址 “链接标题”

代码：

推荐几个不错的网站[Baidu][1],[USTC][2]以及[村上秋水的却其顿小屋][3]。[村上秋水的却其顿小屋][3]是值得你关注的[博客][]。

[1]: http://www.baidu.com "百度"
[2]: http://www.ustc.edu.cn "科大首页"
[3]: http://blog.163.com/snowball_wang/ "村上秋水的却其顿小屋"
[博客]: http://blog.163.com/snowball_wang/ "村上秋水的却其顿小屋"

3.3 自动链接

语法说明：
Markdown支持以比较简单的自动链接形式来处理网址和电子邮件信箱。使用<>就会被自动转换成链接。

代码：

1 2	<http://www.baidu.com> <wjq1996@mail.ustc.edu.cn>

显示效果：
http://www.baidu.com
wjq1996@mail.ustc.edu.cn

4.列表

4.1 无序列表

使用*,+,-表示无序列表。

代码：

1
2
3

- 无序列表项 一
- 无序列表项 二
- 无序列表项 三

显示效果：

无序列表项一
无序列表项二
无序列表项三

4.2 有序列表

代码：

1
2
3

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

显示效果：

有序列表项一
有序列表项二
有序列表项三

4.3 列表缩进

语法说明：

列表项目标记通常是放在最左边，项目标记后面一定要至少接一个空格或制表符。

代码：

1
2

* 忙就中断跑步的话，我一辈子都无法跑步。坚持跑步的理由不过一丝半点，中断跑步的理由却足够装满一辆大型载重卡车。我们只能将那"一丝半点的理由"一个个慎之又慎地不断打磨。见缝插针，得空儿就孜孜不倦地打磨它们。
* 应将自己追问到何处为止？何种程度的修养才是恰当的，而多少又是休息得过分？到何种程度才是妥当，而到什么程度又是狭隘？外部的风景撷取多少为好，而内心的世界又该挖掘多少为妙？对自己的能力应该相信多少，又该对自身有多少的怀疑？

显示效果：

忙就中断跑步的话，我一辈子都无法跑步。坚持跑步的理由不过一丝半点，中断跑步的理由却足够装满一辆大型载重卡车。我们只能将那”一丝半点的理由”一个个慎之又慎地不断打磨。见缝插针，得空儿就孜孜不倦地打磨它们。
应将自己追问到何处为止？何种程度的修养才是恰当的，而多少又是休息得过分？到何种程度才是妥当，而到什么程度又是狭隘？外部的风景撷取多少为好，而内心的世界又该挖掘多少为妙？对自己的能力应该相信多少，又该对自身有多少的怀疑？

4.4 包含段落的列表

语法说明：

列表项目可以包含多个段落，每个项目下的段落都必须缩进4个空格或是1个制表符。

代码：

1
2
3

* 忙就中断跑步的话，我一辈子都无法跑步。坚持跑步的理由不过一丝半点，中断跑步的理由却足够装满一辆大型载重卡车。我们只能将那"一丝半点的理由"一个个慎之又慎地不断打磨。见缝插针，得空儿就孜孜不倦地打磨它们。
    应将自己追问到何处为止？何种程度的修养才是恰当的，而多少又是休息得过分？到何种程度才是妥当，而到什么程度又是狭隘？外部的风景撷取多少为好，而内心的世界又该挖掘多少为妙？对自己的能力应该相信多少，又该对自身有多少的怀疑？
* 同样是十年，与其稀里糊涂地或者，目的明确、生气勃勃地活当然令人远为满意。跑步无疑大有魅力：在个人地局限性中，可以让自己有效地燃烧--哪怕是一丁点，这表示跑步一事的本质，也是活着一事的隐喻。

显示效果：

忙就中断跑步的话，我一辈子都无法跑步。坚持跑步的理由不过一丝半点，中断跑步的理由却足够装满一辆大型载重卡车。我们只能将那”一丝半点的理由”一个个慎之又慎地不断打磨。见缝插针，得空儿就孜孜不倦地打磨它们。
应将自己追问到何处为止？何种程度的修养才是恰当的，而多少又是休息得过分？到何种程度才是妥当，而到什么程度又是狭隘？外部的风景撷取多少为好，而内心的世界又该挖掘多少为妙？对自己的能力应该相信多少，又该对自身有多少的怀疑？
同样是十年，与其稀里糊涂地或者，目的明确、生气勃勃地活当然令人远为满意。跑步无疑大有魅力：在个人地局限性中，可以让自己有效地燃烧–哪怕是一丁点，这便是跑步一事的本质，也是活着一事的隐喻。

4.5 包含引用的列表

语法说明：

如果要在列表项目内放进引用，那>就需要缩进。

代码：

1
2
3

* 阅读的方法：
  >打开书本
  >打开电灯

显示效果：

阅读的方法：

打开书本
打开电灯

5. 引用

语法说明：

引用需要在被引用的文本前加上>符号。

代码：

1
2
3

> 这是一段引用
> 引用内容1
> 引用内容2

显示效果：

这是一段引用

引用内容1

引用内容2

5.1 引用的多层嵌套

区块引用可以嵌套(例如：引用内的引用)，只要根据层次上不同数量的>。

代码：

1
2
3

> 如何才能熟练掌握Markdown语法？ ---初级阶段
> >看教程 ---进阶阶段
> > > 多写文章 ---高级阶段

显示效果：

如何才能熟练掌握Markdown语法？ —初级阶段

看教程 —进阶阶段

多写文章 —高级阶段

5.2 引用其它的要素

引用的区块内也可以使用其他的Markdown语法，包括标题、列表、代码区块等。

代码：

> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
> 代码示例：
> `print "Typora is such an amazing Markdown editor!"`

显示效果：

这是第一行列表项。

这是第二行列表项。
代码示例：
print "Typora is such an amazing Markdown editor!"

6. 插入图片

图片的创建方式与超链接相似，而且和超链接一样也有两种写法，行内式和参考式写法。

语法中图片Alt的意思是如果图片因为某些原因不能显示，就用定义的图片的Alt文字来代替图片。图片Title则和链接中的Title一样，表示鼠标悬停在图片上时出现的文字。Alt和Title都不是必须的，可以省略，但建议写上。

6.1 行内式

语法说明：

![图片Alt](图片地址 "图片Title")

代码：

1 2	海豹 ![海豹](/Markdown语法总结/seal.jpg "海豹")

显示效果：

海豹

seal

6.2 参考式

语法说明：

在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 "Title"

代码：

1
2
3

海豹
![海豹][seal]
[seal]: Markdown语法总结/seal.jpg "海豹"

显示效果：

海豹

7. LaTeX公式

7.1 $表示行内公式

代码：

1	质能守恒方程可以用一个很简单的方程式$E=mc^2$来表达。

显示效果：
质能守恒方程可以用一个很简单的方程式$E=mc^2$来表达。

7.2 $表示整行公式

代码：

1 2	$$\sum_{i=1}^n a_i=0$$ $$f(x_1,x_2,\dots,x_n) = x_1^2 + x_2^2 + \dots + x_n^2$$

显示效果：

$$\sum_{i=1}^n a_i=0$$

$$f(x_1, x_2, \dots, x_n) = x_1^2 + x_2^2 + \dots + x_n^2$$

8. 表格

语法说明：

不论是哪种方式，第一行为表头，第二行分隔表头和主题部分，第三行开始每一行是一个表格行。
列与列之间用管道符|隔开，原生方式的表格每一行的两边也要有管道符。
第二行还可以为不同的列指定对其方式。默认为左对齐，在-后加上:就右对齐。

代码：

简单表格：

姓名|学科|成绩
-|-|-
小强|数学|150
小赛|语文|150
小呆|英语|59

原生表格：

|姓名|学科|成绩|
|-|-|-|
|小强|数学|150|
|小赛|语文|150|
|小呆|英语|59|

表格单元内容设置为右对齐：

姓名|学科|成绩
|-:|-:|-:|
|小强|数学|150|
|小赛|语文|150|
|小呆|英语|59|

显示效果：

简单表格：

姓名	学科	成绩
小强	数学	150
小赛	语文	150
小呆	英语	59

原生表格：

姓名	学科	成绩
小强	数学	150
小赛	语文	150
小呆	英语	59

表格单元内容设置为右对齐：

姓名	学科	成绩
小强	数学	150
小赛	语文	150
小呆	英语	59

9. 分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分割线，行内不能有其它任何东西。Typora不允许符号间有空格。

代码：

1
2
3

***
- - -
- - - - - -

显示效果：
显示效果相同。

10. 代码

语法说明：

插入行内代码，即插入一个单词或者一句代码的情况，使用``这样的形式插入。
插入多行代码，可使用三个`来插入。

10.1 行内式

代码：

1	C语言的函数`scanf()`怎么使用？

显示效果：

C语言的函数scanf()怎么使用？

10.2 多行代码

代码：

 ```C
#include <stdio.h>
int main()
{
    printf("hello world\n");
}

显示效果：

#include <stdio.h>
int main()
{
    printf("hello world\n");
}

10.3 HTML代码

在代码区块里，&、<和>会自动转成HTML实体，这样的方式可以让用户非常容易地使用Markdown插入范例使用地HTML原始码。

代码：

例子1：

1
2
3

<div class="footer">
 @2017 Snowball Wang
</div>

例子2：

<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>王强</td>
        <td>彭赛</td>
        <td>阿呆</td>
    </tr>
</table>

显示效果：

例子1：

1
2
3

<div class="footer">
 @2017 Snowball Wang
</div>

例子2：

<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>王强</td>
        <td>彭赛</td>
        <td>阿呆</td>
    </tr>
</table>