Markdown语法简介

1195次阅读  |  发布于4年以前

目的

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

说明

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

工具

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

语法简介

段落

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

列表

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

有序列表

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

1. a
2. b
3. c

会被识别为:

  1. a
  2. b
  3. 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 33333333333333 4444444444444
111 222 3333 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|

这是一个`测试`

    这是一个测试

说明

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

Copyright© 2013-2020

All Rights Reserved 京ICP备2023019179号-8