MarkDown常用语法

因为HEXO的文章基于markdown,而我写博客又比(ji)较(ben)随(bu)缘(xie),有时时间久了有些语法也就忘了,故在此收录下用过markdown语法,以便之后查阅(持续更新)

1 标题

写法一

1
# [标题名称] //#的个数表示标题的级数,最多支持六级标题

示例

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

效果

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

写法二

1
2
3
4
[标题内容]
------------- //多个-
[标题内容]
============= //多个= 最多两级标题

示例

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

效果

一级标题

二级标题

2 列表

2.1 有序列表

写法

1
[序号]. [列表内容]

示例

1
2
3
4
5
6
0. 一级有序列表
0. 二级有序列表
2. 二级有序列表
2. 三级有序列表
3. 一级有序列表
2. 一级有序列表

效果

  1. 一级有序列表
    1. 二级有序列表
    2. 二级有序列表
      1. 三级有序列表
  2. 一级有序列表
  3. 一级有序列表

PS:markdown的有序列表支持多层渲染,但在渲染有序列表时仅有第一级列表会从0开始递增

2.2 无序列表

写法

1
[* or + or -] [列表名]

示例

1
2
3
4
5
6
7
8
9
10
* 无序列表
+ 无序列表
- 无序列表

+ 无序列表
1. 有序列表
2. 有序列表
- 无序列表
+ 无序列表
1. 有序列表

效果

  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表
    1. 有序列表
    2. 有序列表
  • 无序列表
    • 无序列表
    1. 有序列表

PS:hexo里的markdown测试后好像不支持无序列表内嵌有序列表(会将其渲染为无序列表),网上看其他网站比如简书等是支持该用法的。

3 引用

写法

1
> [引用内容]

示例

1
2
3
4
5
6
> 引用
>> 多级引用
>>>> 多级引用
>> 多级引用

>> 多级引用

效果

引用

多级引用

多级引用
多级引用

多级引用

PS:在多级引用之后若要退出之前的递归需要添加空行重新进行引用。

4 分割线

写法

1
2
---------   // 三个及以上
********* // 三个及以上

示例

1
2
3
4
---
-------
***
*********

效果





可以发现效果是一样的

5 超链接

写法

1
2
[超链接内容](url "title")
<a href="url" target="_blank">超链接内容</a>

说明

示例

1
2
3
4
[百度](https://www.baidu.com)
[Google](https://www.google.com "谷歌")

<a href="https://www.xidian.edu.cn" target="_blank">Xidian</a>

效果

百度
Google

Xidian

PS:默认情况下,Hexo生成的超链接都是绝对地址。例如,如果网站域名为example.com,文章名为hello,那么绝对链接可能像这样:http://example.com/hello.html,它是绝对于域名的。相对链接像这样:/hello.html,也就是说,无论用什么域名访问该站点,都没有关系,这在进行反向代理时可能用到。通常情况下,建议使用绝对地址。

6 图片

写法

1
![Alt text](url "title")

说明

  • Alt text:图片的Alt标签,用来描述图片的关键词,可以不写。最初的本意是当图片因为某种原因不能被显示时而出现的替代文字,后来又被用于SEO,可以方便搜索引擎根据Alt text里面的关键词搜索到图片
  • url:图片url,支持相对地址与绝对地址,同理也支持以绝对地址为链接的网络图片
  • title:图片的标题文字,鼠标悬停即可显示

示例

1
![网络图片](https://fgo.wiki/images/e/ea/%E4%B8%A4%E4%BB%AA%E5%BC%8F%28Saber%29-%E5%A4%B4%E5%83%8F1.png "两仪式")

效果

网络图片

7 文本

7.1 强调

写法

1
2
3
**[强调文本]**
*[斜体文本]*
~~[删除线文本]~~

示例

1
2
3
**这是个粗体段落**
*这是个斜体段落*
~~这是个删除线段落~~

效果

这是个粗体段落
这是个斜体段落
这是个删除线段落

7.2 字体

写法

1
<font face="字体" size="字号" color="颜色">文本</font>

说明:

  • 字体(face):常用字体均有支持,例如黑体, 宋体, 微软雅黑, 楷体等。
  • 字号(size):取值范围[1-7], 默认取值为3。
  • 颜色(color):支持三种格式,包括名称(red、blue、green等)、RGB值(0,0,255等)、3字节编码(#0000FF等)

示例

1
2
3
4
<font face="黑体" size="10" color="red">黑体10号红色</font>
<font face="微软雅黑" size="20" color="black">雅黑20号黑色</font>
<font face="楷体" size="30" color="green">楷体30号绿色</font>
<font face="华文行楷" size="7" color="blue">行楷7号蓝色</font>

效果

黑体2号红色
雅黑4号黑色
楷体6号绿色
行楷7号蓝色

8 代码

写法

1
2
3
4
5
6
7
`[单行代码]`  \单行代码

```(语言标识) \\多行代码
[code1...
code2...
code3]
```

示例

1
2
3
4
5
6
7
8
9
`a = 5 > 4 ? true " no`

```c++
#include<iostream>
using namespace std;
int main() {
cout << "Hello, World!" << endl;
}
```

效果

a = 5 > 4 ? true : no

1
2
3
4
5
#include<iostream>
using namespace std;
int main() {
cout << "Hello, World!" << endl;
}

9 表格

写法

1
2
3
4
表头|表头|表头
-|:-:|-:
内容|内容|内容
内容|内容|内容

说明

  • - 默认格式
  • :- 左对齐
  • -:右对齐
  • :-:居中

示例

1
2
3
4
表头一|表头二|表头三
:-|:-:|-:
左对齐|居中|右对齐
内容一|内容二|内容三

效果

表头一 表头二 表头三
左对齐 居中 右对齐
内容一 内容二 内容三

10 流程图

语法

https://cloud.tencent.com/developer/article/1142260

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
` ``flow
st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes
or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e
```

PS:hexo中显示markdown的流程图需要下载hexo-filter-flowchart插件才能正常显示,因为该插件会直接将代码块转译为HTML,无法在MARKDOWN的代码块中显示,所以在```中加了空格方便对比

效果

11 其他

0%