申明
此贴是由大佬在简书上的教程,本蒟蒻仅作搬运
提到Markdown,很多人首先想到的是简单、Easy等等。的确,Markdown为简单而生。Markdown是由一个叫 JOHN GRUBER 的哥们发明的,它的语法用一篇文章就可以说完。不相信吗?让我们来试试看…
基础语法
标题
Markdown支持6种级别的标题,对应html标签 h1 ~ h6
# h1
## h2
### h3
#### h4
##### h5
###### h6
以上标记效果如下:
h1
h2
h3
h4
h5
h6
除此之外,Markdown还支持另外一种形式的标题展示形式,其类似于 Setext 标记语言的表现形式,使用下划线进行文本大小的控制
这是一级标题
===
这是二级标题
---
使用这种方式处理标题仅有两种表现形式,即一级标题和二级标题。遗憾的是,简书并不支持这种语法。因此,我们用一张图来展示效果:
\
\
这种处理方式在Github的一些开源工程上面比较常见,显而易见的缺点是:文字大小控制级别有限。
段落及区块引用
需要记住的是,Markdown其实就是一种易于编写的普通文本,只不过加入了部分渲染文本的标签而已。其最终依然会转换为html标签,因此使用Markdown分段非常简单,前后至少保留一个空行即可。
而另外一个比较常见的需求就是,我们可能希望对某段文字进行强调处理。Markdown提供了一个特殊符号>用于段首进行强调,被强调的文字部分将会高亮显示
> 这段文字将被高亮显示...
以上标记显示效果如下:
这段文字将被高亮显示…
插入链接或图片
Markdown针对链接和图片的处理也比较简单,可以使用下面的语法进行标记
[点击跳转至百度](http://www.baidu.com)

以上标记显示效果如下:
图片
注: 引用图片和链接的唯一区别就是在最前方添加一个感叹号。
列表
Markdown支持有序列表和无序列表两种形式:
-
无序列表使用*或+或-标识
-
有序列表使用数字加.标识,例如:1.
* 黄瓜
* 玉米
* 茄子
+ 黄瓜
+ 玉米
+ 茄子
- 黄瓜
- 玉米
- 茄子
1. 黄瓜
2. 玉米
3. 茄子
以上标记显示效果如下:
-
黄瓜
-
玉米
-
茄子
-
黄瓜
-
玉米
-
茄子
-
黄瓜
-
玉米
-
茄子
-
黄瓜
-
玉米
-
茄子
注:这里比较有趣的地方是,对于有序列表,Markdown将只关注你的第一个项目的数字编号。例如:如果第一个项目编号是3,以此类推,第二个项目应该是4,最终将显示为3、4、5。而如果你指定了第一个编号,后面的编号指定错误也没有关系,Markdown将只在乎你的第一个项目编号。
使用列表的一些注意事项
如果在单一列表项中包含了多个段落,为了保证渲染正常,*与段落首字母之间必须保留四个空格
* 段落一
小段一
* 段落二
小段二
以上标记显示效果如下:
-
段落一
小段一
-
段落二
小段二
另外,如果在列表中加入了区块引用,区域引用标记符也需要缩进4个空格
* 段落一
> 区块标记一
* 段落二
> 区块标记二
-
段落一
区块标记一
-
段落二
区块标记二
注:记住一个原则,如果在和列表配合使用的时候出现了问题,就缩进一次,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,那就两次。
分隔线
有时候,为了排版漂亮,可能会加入分隔线。Markdown加入分隔线非常简单,使用下面任意一种形式都可以
***
---
产生分隔线的语法要求比较松,符号之间添加空格也可以。
强调
有时候,我们希望对某一部分文字进行强调,使用*或_包裹即可。使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗
*这里是斜体*
_这里是斜体_
**这里是加粗**
__这里是加粗__
这里是斜体
这里是斜体
这里是加粗
这里是加粗

