Hexo-写作语法指南

一.导语

1.本文的主要内容：

Hexo文章书写语法讲解。

2.准备：

什么是 Markdown?

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。

二.语法

1.分级标题

行首加 “#” 表示不同级别的标题 (H1-H6)。“#” 后最好空一格。H1最大，H6最小。并且目录的自动生成也是按照标题来嵌套的。

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

2.文字强调

1
2
3

*内容*---斜体文字
**内容**---加粗文字
***内容***---粗斜体文字

效果展示：

内容
内容
内容

3.列表

*+-表示无序列表。

* 测试0
* 测试1
* 测试2
+ 测试3
+ 测试4
+ 测试5
- 测试6
- 测试7
- 测试8

效果展示：

测试0
测试1
测试2

测试3
测试4
测试5

测试6
测试7
测试8

数字和点1.2.3.表示有序列表。字符后须空一格。

1. 测试1
2. 测试2
3. 测试3
4. 测试4
5. 测试5

效果展示：

测试1
测试2
测试3
测试4
测试5

4.引用

1 2	>引用 >> 引用中引用

效果展示：

引用

引用中引用

5.文本居中的引用

{% cq %} 
文本居中的引用
测试
测试2  
{% endcq %}

效果展示：

暂时有问题

6.分割线

1
2

***
---

效果展示：

7.删除线和下划线

1 2	~~内容~~---删除线 <u>内容</u>---下划线

效果展示：

内容—删除线
内容—下划线

8.行内代码

`内容`

效果展示：

内容

9.代码块

① 某段文本上下一行均加```,或者某段文本上下一行均加~。

效果展示：

代码块测试

② 选择代码主题：打开主题配置文件，搜索highlight，设置highlight_theme的值。

③ 设置代码高亮显示：打开站点配置文件，搜索highlight，设置auto_detect的值为true，如果enable的值不是true改为true。

其中：

line_number：表示是否显示行号
auto_detect：表示是否对未标识的那种语言进行自动检测
tab_replace：是否替换tab为空格

还是不能高亮显示，最终的解决办法是：(如果还不行设置auto_detect的值为false)

10.外部链接

1	[描述](http://www.baidu.com)

效果展示：

描述

11.插入图像

#markdown插入的图片，无法设置大小
![图像测试](https://www.baidu.com/img/bd_logo1.png?where=super)

#img src插入图片可以设置图片的大小
<img src="https://www.baidu.com/img/bd_logo1.png?where=super" width="50%" height="50%" />

效果展示：

12.关于图片位置的存放

① 图片少量时，可以将图片统一放在source/images文件夹中，通过![替代文字](/images/image.jpg)来访问。

② 打开站点配置文件，设置post_asset_folder为true。运行npm install hexo-asset-image –save，安装上传图片的插件。安装完成后，再运行hexo new xxx来生成md文件时，/source/_posts文件夹内除了xxx.md文件还有一个同名的文件夹，这个文件夹用来存放博文中用到的图片，引用图片时通过正常语法![替代文字](xxx.png)引用。

③ 将所有的图片存放在云端，我选择的是腾讯云，上传图片后会有一个访问链接，复制，通过![替代文字](访问链接)引用。

13.缩进

一个汉字占两个空格大小
&nbsp;&nbsp;&nbsp;&nbsp;#一个代表半个空格
&ensp;&ensp;#一个代表一个空格
&emsp;#一个代表两个个空格

效果展示：

一个汉字占两个空格大小
#一个代表半个空格
#一个代表一个空格
#一个代表两个个空格

14.换行

1	在行中加<br>即换行，在行末加<p>即空行；在行中插入分隔线<hr/>测试分隔线中。

效果展示：

在行中加
即换行，在行末加

即空行；在行中插入分隔线

测试分隔线中。

15.转义符

在特殊字符前面加\可使特殊字符转换为正常字符，而不是被识别为markdown语法符号。如：

1	\\\`\*\_\{\}\[\]\(\)\#\+\-\.\!

效果展示：

\`*_{}[]()#+-.!

16.脚注

1	比如test[^1\],脚注2是[^2\]是这样的

效果展示：

比如test[^1],脚注2是[^2]是这样的

17.表格

|姓名|性别|年龄|分数|
|---|:---:|:---|---:| 
|张三|男|8|60|
|李四|女|20|90|
|默认|居中|左对齐|右对齐|

效果展示：

姓名	性别	年龄	分数
张三	男	8	60
李四	女	20	90
默认	居中	左对齐	右对齐

18.上标与下标

1
2
3

测试文字<sub>这是下标文本</sub>

测试文字<sup>这是上标文本</sup>

效果展示：

测试文字_{这是下标文本}

测试文字^{这是上标文本}

19.字体加大和缩小

<small><small>最小字号</small></small>
<small>小字号</small>
<big>大字号</big>
<big><big>大大字号</big></big>
<big><big><big>大大大字号</big></big></big>
<big><big><big><big>继续加可以继续大下去</big></big></big></big>

效果展示：

最小字号
小字号
大字号
大大字号
大大大字号
继续加可以继续大下去

20.添加ICO图标

可以在Font Awesome官网查找ICO图标，然后通过class方法添加。

<i class="fa fa-pencil"></i> 铅笔
<i class="fa fa-cloud-upload"></i> 上传
<i class="fa fa-download"></i> 下载
<i class="fa fa-download fa-lg"></i> 下载变大 33%
<i class="fa fa-download fa-2x"></i> 下载两倍大

效果展示：

铅笔
上传
下载
下载变大 33%
下载两倍大

21.Bootstrap标注

{% note class_name %} 文字内容 (md class_name supported) {% endnote %}
{% note primary %} 文字内容 (md primary supported) {% endnote %}
{% note default %} 文字内容 (md default supported) {% endnote %}
{% note success %} 文字内容 (md success supported) {% endnote %}
{% note info %} 文字内容 (md info supported) {% endnote %}
{% note warning %} 文字内容 (md warning supported) {% endnote %}
{% note danger %} 文字内容 (md danger supported) {% endnote %}

效果展示：

文字内容 (md class_name supported)

文字内容 (md primary supported)

文字内容 (md default supported)

文字内容 (md success supported)

文字内容 (md info supported)

文字内容 (md warning supported)

文字内容 (md danger supported)

22.设置文字颜色

1 2	<font color="red"><big>测试内容</big></font> <font color="#0000FF">测试内容</font>

效果展示：

测试内容
测试内容

23.待办事宜列表

- [ ] 支持以 PDF 格式导出文稿
- [ ] 改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
- [x] 新增 Todo 列表功能
- [x] 修复 LaTex 公式渲染问题
- [x] 新增 LaTex 公式编号功能

效果展示：

支持以 PDF 格式导出文稿
改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
新增 Todo 列表功能
修复 LaTex 公式渲染问题
新增 LaTex 公式编号功能

24.辅助排版符号

键盘打不出的，复制-粘贴即可

直角引号比较古典，尤其用在标题中：「」和『』代替“ ”

▍这个加在分级标题前效果好

▏这个在段落前等于是空格

各种三角 ▷ ◁ ▶ ◀ △▽▲▼

➥ 和 → 还有 ˉˉ↴ 以及 ➨ 起引导视线的作用

☛ 这个是点击

☑ 和 ✔ 是已经选择，OK

✘ 是错误，删除，NO

✄ 是剪切

❐ 这个是复制粘贴

✚ 是添加，补充，选项

☷ 是列表，调整格式

① ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨ ⑩ 这样的数字是不是很酷

罗马数字（Ⅰ·Ⅱ·Ⅲ·Ⅳ·Ⅴ·Ⅵ·Ⅶ·Ⅷ·Ⅸ·Ⅹ·Ⅺ·Ⅻ）比较优雅复古

25.居中和右对齐

<!-- 居中 -->
<center>内容</center>
<!-- 右对齐 -->
<div style="text-align:right">内容</div>

效果展示：

内容

26.选项卡

{% tabs 选项卡, 2 %}
<!-- tab -->
**这是选项卡 1** 呵呵哈哈哈哈哈哈
<!-- endtab -->
<!-- tab -->
**这是选项卡 2** 额。。。
<!-- endtab -->
<!-- tab -->
**这是选项卡 3** 哇，你找到我了！
<!-- endtab -->
{% endtabs %}