我是瘦子

Markdown 的常用语法

简介

Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown 支持嵌入 html 标签。
注意:Markdown 使用 #+* 等符号来标记, 符号后面必须跟上至少1个空格才有效!

Markdown的常用语法

标题

Markdown 标题支持两种形式:

# 标记

标题开头 加上1~6个#,依次代表一级标题、二级标题….六级标题

代码如下:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题


列表

Markdown 支持有序列表和无序列表。
无序列表使用 -+* 作为列表标记:

1
2
3
4
5
6
7
8
9
10
11
- Red
- Green
- Blue

* Red
* Green
* Blue

+ Red
+ Green
+ Blue

效果如下:

  • Red
  • Green
  • Blue

有序列表则使用数字加英文句点.来表示:

1
2
3
1. Red
2. Green
3. Blue

效果如下:

  1. Red
  2. Green
  3. Blue

引用

引用以 > 来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。
常见的引用写法:

1
> 这是一段引用    // 在 `>` 后面有 1 个空格

效果如下:

这是一段引用,在 > 后面有 1 个空格

Next 主题内置引用标签,使用方式

1
{% note class_name %} Content (md partial supported) {% endnote %}

效果如下:

这是一段来自 Next 主题内置引用标签, default 样式主题的引用

这是一段来自 Next 主题内置引用标签, primary 样式主题的引用


这是一段来自 Next 主题内置引用标签, success 样式主题的引用

这是一段来自 Next 主题内置引用标签, info 样式主题的引用


这是一段来自 Next 主题内置引用标签, warning 样式主题的引用

这是一段来自 Next 主题内置引用标签, danger 样式主题的引用


强调

两个*-代表加粗,一个*-代表斜体,~~代表删除。

1
2
3
4
5
**加粗文本** 或者 __加粗文本__

*斜体文本* 或者_斜体文本_

~~删除文本~~

效果如下:
加粗文本 或者 加粗文本
斜体文本 或者斜体文本
删除文本


图片与链接

图片与链接的语法很像,区别在一个 ! 号。二者格式:

1
2
3
图片:![]()    ![图片文本(可忽略)](图片地址)

链接:[]() [链接文本](链接地址)

链接又分为行内式参考式自动链接

1
2
3
4
5
6
7
8
9
10
11
12
13
这是行内式链接:[ConnorLin's Blog](http://connorlin.github.io)。

这是参考式链接:[ConnorLin's Blog][url],其中url为链接标记,可置于文中任意位置。

[url]: http://connorlin.github.io/ "ConnorLin's Blog"

链接标记格式为:[链接标记文本]: 链接地址 链接title(可忽略)

这是自动链接:直接使用`<>`括起来<http://connorlin.github.io>

这是图片:![][avatar]

[avatar]: https://connorlin.github.io/images/avatar.jpg

效果如下:
这是行内式链接:ConnorLin’s Blog

这是参考式链接:ConnorLin’s Blog,其中url为链接标记,可置于文中任意位置。

这是自动链接:直接使用<>括起来 http://connorlin.github.io

这是图片:


代码

代码分为 行内代码代码块

行内代码用两个反单引号(前后各一个)表示,例如:code
代码块用三个反单引号,例如:

1
console.log('....')

表格

表格对齐格式

  • 居左::—-
  • 居中::—-:或—–
  • 居右:—-:

例子:

1
2
3
4
5
6
|标题|标题|标题|
|:---|:---:|---:|
|居左测试文本|居中测试文本|居右测试文本|
|居左测试文本1|居中测试文本2|居右测试文本3|
|居左测试文本11|居中测试文本22|居右测试文本33|
|居左测试文本111|居中测试文本222|居右测试文本333|

效果如下:

标题 标题 标题
居左测试文本 居中测试文本 居右测试文本
居左测试文本1 居中测试文本2 居右测试文本3
居左测试文本11 居中测试文本22 居右测试文本33
居左测试文本111 居中测试文本222 居右测试文本333

分隔线

在一行中用三个以上的 *-_ 来建立一个分隔线,行内不能有其他东西。也可以在符号间插入空格。
效果均为一条分割线:

1
2
3
4
5
6
7
*****

_____

-----

* * * * *

效果如下:





相关内容转载自:https://www.jianshu.com/p/82e730892d42
参考资料1:http://www.cnblogs.com/skyhuangdan/p/5485069.html
参考资料2:https://www.appinn.com/markdown/
主要是为了方便自己书写用,最起码有个留存。