沐光

记录在前端之路的点点滴滴

markdown 语法

前言

由于写文章时经常会用到 Markdown 语法,但是除了基础的 Markdown 语法外,hexo 还支持一些语法扩展,因此为了方便查找扩展语法,写此篇以做记录。

区块元素

段落与换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行(此便是段落)。

Markdown 中多个空格表示换行,除此外 <br /> 标签也表示换行(回车会处理成空格)。

推荐的换行方式:两次回车,这样结构更清晰一些

标题

标题使用 # 表示其层级(还有下等号或横线的形式,单不推荐)

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

由于 一、二、三级标题都有下划线,个人偏向从三级标题开始,下划线过多看区块划分不是很舒服。

区块引用

区块引用只需要在没行前添加 > 符号即可,可嵌套 markdown 语法,例如:

1
2
> > 嵌套引用
> **嵌套加粗**

列表

无序列表

无序列表一般通过 -* 或者 + 作为其语法,例如:

1
2
3
- 项目一
- 项目二
- 项目三
有序列表

有序列表用 阿拉伯数字 来表示,例如:

1
2
3
1. 项目 A
2. 项目 B
3. 项目 C
列表段落

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:

1
2
3
*   This is a list item with two paragraphs.
> This is the second paragraph in the list item.
* Another item in the same list.

代码区块

代码区块只要简单地缩进 4 个空格或是 1 个制表符就可以,此处推荐使用 ``` 来包裹代码块,如:

1
2
3
`` html
<p>这是 html 代码</p>
``

注:为了能展示代码块的写法,此处省略了一个 `

分割线

一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。如:

1
------

表格

表格写法稍微复杂一点,第二行中的 : 表示对齐方式,默认左对齐

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

区段元素

链接和图片

链接的语法为:

1
[中文提示](<address>)

图片语法为

1
![中文提示](<address>)

强调

Markdown 使用双星号(*)或双底线(_)作为标记强调字词的符号,例如:

1
**强调部分**

斜体

Markdown 使用单星号(*)或双底线(_)作为标记强调字词的符号,例如:

1
*斜体部分*

其它

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,如 *

1
\*literal asterisks\*

拓展语法

引用块

1
2
3
{% quote David Levithan, Wide Awake %}
Do not just seek happiness for yourself. Seek happiness for all. Through kindness. Through mercy.
{% endquote %}

Do not just seek happiness for yourself. Seek happiness for all. Through kindness. Through mercy.

David LevithanWide Awake

居中引用

1
2
3
{% cq User Name%}
This is a center quoet list
{% endcq %}

This is a center quoet list

笔记块

1
2
3
{% note default %}
Any content (support inline tags too.io).
{% endnote %}

Any content (support inline tags too.io).

笔记块有 2 参数:
第一个为类型:[default | primary | success | info | warning | danger]
第二个表面是否显示图标(写了右侧内容就没 icon 了): no-icon

参考文章