目的

对Markdown的语法进行最基础简单的介绍,能够满足在各个方面的基本使用。

说明

markdown语法目前有两种,我会选择一种我在实践过程中认为比较简单的标记来进行简单介绍。如果需要进行查阅,可以直接阅读末尾总结部分。

markdown也支持部分HTML,如果需要实现换行等需求也可以使用<br/>等来完成。

不同的markdown语法识别器可能会对统一份markdown语法产生不同的解释,属于正常现象。

segmentfault的markdown解释器就和我使用的MacDown产生了不同的结果,害得我调调整了好久囧~~

工具

本人是在Mac上进行工作与开发,因此推荐Mac上的软件——MacDown进行开发,windows上的用户可以自行挑选较为合适的客户端或者选择跨平台的线上编辑器。

语法简介

段落

段落以#号开头,1个#代表为一级标题,以此类推,2~6个#分别为2~6级标题。其中#后建议添加一个空格

列表

列表分为有序列表和无序列表两种。

有序列表

数字+.+空格为开头的语句,会被识别成为一个有序列表。例如:


1.(空格)a
2.(空格)b
3.(空格)c

会被识别为:

  1. a

  2. b

  3. c

无序列表

-+空格为开头的语句,会被识别为一个无序列表。例如:

-(空格)a
-(空格)b
-(空格)c

会被识别为:

  • a

  • b

  • c

链接

符合[名字]+(网址)格式的语句会被识别为一个超链接,其中小括号中为超链接显示的名字,而中括号为链接的网址。例如:

[百度](www.baidu.com)

会被识别为:

百度

图片

符合!+[]+(图片网址)格式的语句会被识别为一个图片,其中小括号为图片的网址。例如:


![](http://www.taopic.com/uploads/allimg/120628/201776-12062Q4295216.jpg)

会被识别为:

引用

符合>+空格格式的语句会被识别为一个图片,其中后面紧接的文字为引用文字。例如:

(>)(空格)引用——去掉大于号左右的括号

会被识别为:

引用

倾斜、加粗与分割线

倾斜与加粗的格式类似,都是*+文字+*,*号中的文字为倾斜或者加粗的文字。其中倾斜为一个*号,而加粗为两个*号, 分割线为***。例如:

*倾斜*
**加粗**
***

会被识别为:

倾斜

加粗


表格

表格的格式比较复杂,我们先看一个例子:

|line1|line2|line3|line4|
|:--|--:|:-:|---|
|111|222|333|444|
|111|222|333|444|

会被识别为:

line1 line2 line3 line4
111 222 333 444
111 222 333 444

让我们来看下具体的语法:
表头以竖线间隔开头,每个间隔内的文字都是列头。:表示当前列的对齐位置,在最左边为局左对齐,在最右边为居右对齐,如果两边各有一个,则表示居中对齐,如果没有冒号,则不需要对齐。第二列每个竖线中至少有3个字符(可以多,不可以少,冒号最多存在两个——居中对齐情况)来表示对齐的方式。

下面每个竖线内都是对应该列的内容,后面若干列如果为空可以不需要写竖线。

代码

代码有两种方式,一种是行内方式,具体请看示例。

这是一个`测试`

    这是一个测试
    

会被识别为:

这是一个测试


这是一个测试

从上面的例子我们可以看到,用`包裹的内容为行内的代码引用。如果是以缩进为开头的语句,则会是整行的引用。

总结

所有样式总结如下:

# 标题1
## 标题2
### 标题3
#### 标题4
##### 标题5
###### 标题6

1.(空格)有序列表1
2.(空格)有序列表2

-(空格)无序列表1
-(空格)无序列表2

[链接名](链接地址)

![](链接图片)

(>)(空格)引用——去掉大于号左右的括号

*倾斜*
**加粗**
*** 分割线

|line1|line2|line3|line4|
|:--|--:|:-:|---|
|111|222|333|444|
|111|222|333|444|

这是一个`测试`

    这是一个测试



hjava
1.9k 声望525 粉丝

字节客服平台电商前端负责人,欢迎投简历来撩:huangjue.hjava@bytedance.com