Hexo 博客要求必须使用 Github 风格的 Markdown 语言编辑。所以需要了解具体的编写格式。
一、编辑器
市面上有很多的 Markdown 编辑器，之前很多人喜欢用 Typora，但目前这个已经没有免费版可以用了。干脆直接用 VSCode。
使用 VSCode 需要下载两个插件，第一个是【Markdown All in
One】，是一个组合包，把最常用的 markdown 优化都安装好；第二个是【Markdown
Preview Github
Styling】, 是 Github 使用的 Markdown 渲染样式。使用这个样式，在本地就能预览 Markdown 文件最终在 Github
Pages 中显示的效果。
二、常用语法
标题
利用#设置标题，一个表示一级，两个表示二级，依次类推
1
2
3
| # 一级标题
## 二级标题
……………… 以此类推
|
引用
利用 > 可以创建引用块
文本高亮
利用一组反引号 ` 来把文本包起来。
代码块
利用三个反引号 ` 把内容扩起来即可。在上面的那个反引号后面还可以加上语言名称来进行自适应。
斜体
可以用一组 * 号来把文字包起来，也可以直接用快捷键 Ctrl+I。
加粗
k 可以用一组 ** 来把文字包起来，也可以用快捷键 Ctrl+B。
删除线
用一组 ~~ 把文字包起来。
下划线
下划线可以用 <u> </u>把文字包起来。
按键效果
可以用一组<kbd> </kbd> 把文字包起来，实现按键效果。
列表
列表分为有序列表和无序列表
1
2
3
4
5
6
7
| 无序列表：用-加空格
- 第一
- 第二
有序列表：用数字加.加空格
1. 第一
2. 第二
|
三、链接与图片
图片其实是一种超链接，所以把图片归类为链接里面。
1、跳转链接
普通的网站跳转都属于跳转链接，语法很简单：
2、图片链接
图片链接的 markdown 语法和跳转链接类似：
3、图片存储
网上很多教程都是利用相对路径来存储图片，操作如下： 1. 安装图片插件
1
| npm install hexo-asset-image --save
|
- _config.yml 配置文件中，修改为 post_asset_folder: true
其中第二步可以忽略，第二步的意义在于我们新建文章的时候，会在 soruce 目录下生成文章同名文件夹供我们存储图片，我们也可以手动创建文件夹。
但是对于 GitPages 或者云服务器来说，其提供的免费存储空间都是有上限的，这样操作只适用于图片较少的情况。我们可以利用云服务器对象存储功能实现图床。
我的域名使用的是腾讯的，那就用腾讯的 COS 来操作，并且腾讯提供可视化工具 COSBrowser，很方便。
参考博客： Hexo
博客图片添加至图床 --- 腾讯云 COS 图床使用
一个图片测试：
四、公式
公式使用的是 Latex 语法。但需要注意，Hexo 并不支持 Laxte 语法，所以我们需要开启相关的开关。有些主题就自带这个功能。
Markdown 使用 $ 包裹实现行间公式。
Latex 语法可以不掌握，借助工具即可： HostMath
不过 Hexo 显示数学公式还需要一些其他设置，Hexo 默认使用
hexo-renderer-marked 引擎渲染网页，该引擎会把一些特殊的 markdown
符号转换为相应的 html 标签，导致公式不显示。
五、表格
1
2
3
4
5
6
| | 1 | T2 | T3 |
|----------|:-------------:|------:|
| 1 | 1 | 1 |
| 22 | 22 | 22 |
| 333 | 333 | 333 |
|
| 1 |
1 |
1 |
| 22 |
22 |
22 |
| 333 |
333 |
333 |
------ 表示左对齐，:------：表示居中，-----: 表示右对齐
Hexo 的表格必须和正文之间有空行，否则不能正常显示
六、流程图
Hexo 里流程图限制多多，直接在其他软件画完截图吧。我也懒得学了。【流汗黄豆】
七、特殊字符
常见转义如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
| ! !
” "
# #
$ $
% %
& &
‘ '
( (
) )
* *
+ +
< <
= =
- -
> >
? ?
@ @
[ [
\ \
] ]
{ {
| |
} }
|
八、hexo 模板
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
| # ！！！！！！！！！！
# 每一项的 : 后面均有一个空格
# 且 : 为英文符号
# ！！！！！！！！！！
title:
# 文章标题，可以为中文
date:
# 建立日期，如果自己手动添加，请按固定格式
# 就算不写，页面每篇文章顶部的发表于……也能显示
# 只要在主题配置文件中，配置了 created_at 就行
# 那为什么还要自己加上？
# 自定义文章发布的时间
updated:
# 更新日期，其它与上面的建立日期类似
# 不过在页面每篇文章顶部，是更新于……
# 在主题配置文件中，是 updated_at
permalink:
# 若站点配置文件下的 permalink 配置了 title
# 则可以替换文章 URL 里面的 title（文章标题）
categories:
# 分类，支持多级，比如：
# - technology
# - computer
# - computer-aided-art
# 则为 technology/computer/computer-aided-art
# （不适用于 layout: page）
tags:
# 标签
# 多个可以这样写 [标签1,标签2,标签3]
# （不适用于 layout: page）
description:
# 文章的描述，在每篇文章标题下方显示
# 并且作为网页的 description 元数据
# 如果不写，则自动取 <!-- more -->
# 之前的文字作为网页的 description 元数据
keywords:
# 关键字，并且作为网页的 keywords 元数据
# 如果不写，则自动取 tags 里的项
# 作为网页的 keywords 元数据
comments:
# 是否开启评论
# 默认值是 true
# 要关闭写 false
layout:
# 页面布局，默认值是 post，默认值可以在
# 站点配置文件中修改 default_layout
# 另：404 页面可能用到，将其值改为 false
type:
# categories，目录页面
# tags，标签页面
# picture，用来生成 group-pictures
# quote？
# https:
photos:
# Gallery support，用来支持画廊╱相册，用法如下：
# - photo_url_1
# - photo_url_2
# - photo_url_3
# https:
link:
# 文章的外部链接
# https:
image:
# 自定义的文章摘要图片，只在页面展示，文章内消失
# 此项只有参考本文 5.14 节配置好，否则请勿添加！
sticky:
# 文章置顶
# 此项只有参考本文 5.15 节配置好，否则请勿添加！
password:
# 文章密码，此项只有参考教程：
# http:
# 第 24 节，配置好，否则请勿添加！
# 发现还是有 bug 的，就是右键在新标签中打开
# 然后无论是否输入密码，都能看到内容
|