markdown 语法

前言

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

区块元素

段落与换行

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

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

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

标题

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

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

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

区块引用

区块引用只需要在没行前添加 > 符号即可，可嵌套 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 个制表符就可以，此处推荐使用 ``` 来包裹代码块，如：

`` html

<p>这是 html 代码</p>
``

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

分割线

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

------

表格

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

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

区段元素

链接和图片

链接的语法为：

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

图片语法为

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

强调

Markdown 使用双星号（*）或双底线（_）作为标记强调字词的符号，例如：

**强调部分**

斜体

Markdown 使用单星号（*）或双底线（_）作为标记强调字词的符号，例如：

*斜体部分*

其它

反斜杠

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

沐光