Markdown常用语法

标题

在Markdown中,标题一共分为六级,只需在文字前加上 # 即可,这类标题也可以选择闭合,闭合只是为了美观,由行首的井字符数量决定标题的阶数。代码:

1
2
3
4
5
6
# h1
## h2
### h3
#### h4
##### h5
###### h6

分级标题

与标题作用类似,=- 最少可只写一个,兼容性一般。代码:

1
2
3
4
一级标题
============
二级标题
------------

目录

根据标题生成目录,兼容性一般,nexT主题已经开启自动生成目录。代码:

1
[TOC]

引用

引用可以分为单行引用和多行引用(引用块),同时只要根据层次加上 > 就可以实现嵌套引用,引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。代码:

单行式

1
> hello world!

效果:

hello world!

多行式

1
2
> hello world!
brand new world!

1
2
> hello world!
> brand new world!

效果相同:

hello world!
brand new world!

嵌套式

1
2
> hello world!
>> brand new world!

效果:

hello world!

brand new world!

代码块

代码块可分为行内代码块和多行代码块。代码:

行内代码

1
`<div></div>`

效果:
<div></div>

代码块

用三个反引号包裹一串代码,或者使用Tab缩进。注意要空开一行书写。
效果:

<div>   
    <div></div>
    <div></div>
    <div></div>
</div>

自定义语法

该方法可以根据不同的语言配置不同的代码着色。(代码在使用的时候去掉前面的反斜杠,这里为了防止被编译而加上)

1
2
3
4
5
6
\```javascript
var num = 0;
for (var i = 0; i < 5; i++) {
num+=i;
}
\```console.log(num);

效果:

1
2
3
4
5
var num = 0;
for (var i = 0; i < 5; i++) {
num+=i;
}
console.log(num);

列表

Markdown中支持两种列表:无序列表和有序列表。

无序列表

无序列表有三种语法,可使用 *+-作为列表标记。代码:

1
2
3
*   Red
* Green
* Blue

1
2
3
+   Red
+ Green
+ Blue

1
2
3
-   Red
- Green
- Blue

效果:

  • Red
  • Green
  • Blue

有序列表

在列表标记上使用的数字并不会影响输出的 HTML 结果,即可以让 Markdown 文件的列表数字和输出的结果相同,也可以完全不用在意数字的正确性。代码:

1
2
3
1.  Bird
2. McHale
3. Parish

效果:

  1. Bird
  2. McHale
  3. Parish

分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。代码:

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

***

*****

- - -

---------------------------------------

效果:


链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。不管是哪一种,链接文字都是用 [方括号] 来标记。

行内式

要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可。代码:

1
[an example](http://example.com/"Title"){:

效果:
an example

参考式

该链接必须带 http:// ,否则会被解析成本地路径,代码:

1
2
[an example][id]
[id]: http://example.com/

效果:
an example

图片

Markdown 使用一种和链接很相似的语法来标记图片,和链接的主要区别在于在最开头需要标记 ! 。同样分为行内式和参考式。

行内式

方括号中用来放图片无法正常显示时的替代文字,代码:

1
![Alt text](../assets/blogImg/avatar.png)

参考式

代码:

1
2
![Alt text][01]
[01]: ../assets/blogImg/avatar.png

效果:
Alt text

任务列表

注意要空开一行书写。代码:

1
2
3
- [x] 选项一
- [ ] 选项二
- [ ] [选项3]

效果:

  • 选项一
  • 选项二
  • 选项三

表格

: 代表对齐方式 , :| 之间不要有空格,否则对齐会有些不兼容。代码:

1
2
3
4
|    a    |       b       |      c     |
|:-------:|:------------- | ----------:|
| 居中 | 左对齐 | 右对齐 |
|=========|===============|============|

效果:

a b c
居中 左对齐 右对齐
========= =============== ============

简约写法:

1
2
3
4
a | b | c  
:-:|:- |-:
居中 | 左对齐 | 右对齐
============|=================|=============

字体

描述 效果 代码
斜体 斜体 *斜体*
斜体 斜体 _斜体_
加粗 加粗 **加粗**
加粗+斜体 加粗+斜体 ***加粗+斜体***
加粗+斜体 加粗+斜体 **_加粗+斜体_**
删除线 删除线 ~~删除线~~