hexo 文章的创建及 markdown 语法

hexo 创建文章

命令行输入：

1

$ hexo new "new article"

之后在 source/_posts 目录下面，多了一个 new-article.md 的文档。
打开后：

1
2
3
4
5

---
title: new article
date: 2018-09-28 20:10:33
tags:
---

文档的开头是属性，采用统一的 yaml 格式，用三条短横线分隔。下面是文章正文， 文章的正文支持 markdown 格式。
新建、删除或修改文章后，不需要重启 hexo server，刷新一下即可预览。

属性

文章可以拥有如下属性：

分类和标签

分类只有一个，但标签可以有多个且有两种写法如下：

1
2
3
4
5
6
7
8
9
10

---
...
categories: "工具"
tags:
    - hexo
    - markdown
    - 前端


---

文章缩略图和 banner

注： 不同主题设置可能不同，本部分只针 icarus 主题， 其他主题仅供参考
当只设置 banner 时，文章的缩略图 和 banner 将都是 banner 所设置的图片；
当只设置 thumbnail 时， 文章只有缩略图，无 banner
当同时设置 banner 和 thumbnail 时，banner 为 banner 图，thumbnail 为缩略图， 两者各自生效；

设置图片前要在当前文章所在目录新建一个同名文档夹，用于存放图片等静态文档，如图；

或者修改配置文档_config.yml

1

post_asset_folder: true 

此时创建新文章时会自动在同级目录下生成同名文档夹用于存放静态文档，不同的主题可通过 thumbnail 和 banner 两个属性来设置缩略图和 banner

文章缩略图设置：

1
2
3
4

---
...
thumbnail: https://...        
---

文章 banner 设置：

1
2
3
4

---
...
banner: https://...           # 此处为图片地址
---

注： 若引用本地图片时，需要加上路径前缀，如下图：

则引用路径为：

1

banner: /blog/2018/09/27/hexo-创建文章/banner.jpg

MarkDown 语法

斜体和粗体

1
2
3
4

这是斜体 或 这也是斜体 
这是粗体
这是加粗斜体
这是删除线

效果

这是斜体 或 这也是斜体
这是粗体
这是加粗斜体
这是删除线

分级标题

1
2
3
4
5
6

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

超链接

1
2
3
4
5

行内形式：我的博客
参考形式：[我的博客][1]，有一个很好的平台-[GitHub][2]
[1]:https://kevinpu.github.io/
[2]:http://www.jianshu.com/
自动链接：我的博客地址<https://zhangjichengcc.github.io/blog/>

效果

行内形式：我的博客
参考形式：[我的博客][1]，有一个很好的平台-[GitHub][2]
[1]:https://zhangjichengcc.github.io/blog/
[2]:https://zhangjichengcc.github.io/
自动链接：我的博客地址https://zhangjichengcc.github.io/blog/

列表

无序列表：

1
2
3

* 无序列表项1
+ 无序列表项2
- 无序列表项3

效果

• 无序列表项 1

• 无序列表项 2

• 无序列表项 3

有序列表

1
2
3

1.有序列表项1
2.有序列表项2
3.有序列表项3

效果

1.有序列表项 1
2.有序列表项 2
3.有序列表项 3

插入图片

1

表格

1
2
3
4
5

| 表头1|表头2|表头3|表头4
|-| :- | :-: | -: |
|默认左对齐|左对齐|居中对齐|右对齐|
|默认左对齐|左对齐|居中对齐|右对齐|
|默认左对齐|左对齐|居中对齐|右对齐|

效果

code

1
2

``` bash
...code 主体

效果

1

...code 主体

引用

1
2
3
4

>这是引用
这是引用
这是引用
>>不！我才是引用

效果

这是引用
这是引用
这是引用