前言
介于 Markdown 语法较为繁琐，记录于此方便查询
标题
使用 # 来表示标题，其中 # 的数量表示标题的级别，比如 # H1 表示 <h1>H1</h1>，### H3 表示 <h3>H3</h3>
为保证兼容性，请在 # 后面添加空格
# H1
#H1
段落
直接写就行了，使用空白行表示进行段落分隔
| Markdown 语法 | 预览效果 |
|---|---|
这是一段 Markdown这是另一段 Markdown |
这是一段 Markdown 这是另一段 Markdown |
请不要用 space 或 tab 来进行缩进
换行
在行的末尾添加两个及以上的 space 然后回车即可
| Markdown 语法 | 预览效果 |
|---|---|
这是第一行 这是第二行 |
这是第一行 这是第二行 |
强调
粗体
在字符前后添加 ** 来表示粗体
| Markdown 语法 | 预览效果 |
|---|---|
这是**粗体** |
这是粗体 |
我**爱**你 |
我爱你 |
斜体
在字符前后添加 * 来表示斜体
| Markdown 语法 | 预览效果 |
|---|---|
这是*斜体* |
这是斜体 |
我*爱*你 |
我爱你 |
粗体 + 斜体
在字符前后添加 *** 来表示粗斜体
| Markdown 语法 | 预览效果 |
|---|---|
这是***粗斜体*** |
这是粗斜体 |
我***爱***你 |
我爱你 |
引用
在段落前添加 > 表示引用
单段引用
1 | > 这是一段引用 |
这是一段引用
多段引用
1 | > 这是多段引用 |
这是多段引用
这是第二段引用
嵌套引用
1 | > 这是引用 |
这是引用
这是嵌套引用
带其他元素的引用
1 | > 这是引用 |
这是引用
- 这是带列表的引用
- 这也是带列表的引用
这是个带斜体的引用
列表
有序列表
使用 <数字>. 来创建一个有序列表，其中数字可以不按顺序写，但请务必确保以 1. 为起始
| Markdown 语法 | 预览效果 |
|---|---|
1. 第一行2. 第二行3. 第三行4. 第四行 |
|
1. 第一行1. 第二行1. 第三行1. 第四行 |
|
1. 第一行8. 第二行5. 第三行3. 第四行 |
|
1. 第一行2. 第二行3. 第三行 1. 子列表 2. 子列表4. 第四行 |
|
无序列表
使用 + 或 - 或 * 来创建一个无序列表
| Markdown 语法 | 预览效果 |
|---|---|
- 第一行- 第二行- 第三行- 第四行 |
|
* 第一行* 第二行* 第三行* 第四行 |
|
+ 第一行+ 第二行+ 第三行+ 第四行 |
|
- 第一行- 第二行- 第三行 - 子列表 - 子列表- 第四行 |
|
请不要这样做
1 | + 第一行 |
代码
在字符前后添加 `` 表示代码
| Markdown 语法 | 预览效果 |
|---|---|
这是一段 ``代码`` |
这是一段 代码 |
分隔符
可使用以下三种方式表达分隔符
1 | *** |
分隔符在这 ↓
分隔符在这 ↑
请在分隔符前后添加空白行
链接
| Markdown 语法 | 预览效果 |
|---|---|
这是一个[超链接](https://tigsrk.cn/2017/10/21/markdown/) |
这是一个超链接 |
这是一个[带标题的超链接](https://tigsrk.cn/2017/10/21/markdown/ "标题") |
这是一个带标题的超链接 |
这是一个链接：<https://tigsrk.cn/2017/10/21/markdown/> |
这是一个链接：https://tigsrk.cn/2017/10/21/markdown/ |
这是一个邮箱：<certain_scientific@tigsrk.cn> |
这是一个邮箱：certain_scientific@tigsrk.cn |
图片
基本格式为 
1 |  |
表格
以如下形式创建表格，其中的 --- 可使用任意三个以上的 -
1 | | 标题 1 | 标题 2 | |
| 标题 1 | 标题 2 |
|---|---|
| 内容 1 | 内容 2 |
| 内容 3 | 内容 4 |
在 --- 的左右两边添加 : 来进行对齐
1 | | 标题 1 | 标题 2 | 标题 3 | |
| 标题 1 | 标题 2 | 标题 3 |
|---|---|---|
| 内容 1 | 内容 2 | 内容 3 |
| 内容 4 | 内容 5 | 内容 6 |
代码块
代码块由两个 ``` 所组成，其中第一个使用在代码开头前，另一个使用在代码结束之后
1 | ``` |
1 | 这是代码块 1 |
可在第一个 ``` 的后面指定一种语音让其高亮
1 | ```python |
1 | from time import sleep |
删除线
在字符前后添加 ~~ 表示删除线
| Markdown 语法 | 预览效果 |
|---|---|
这是一个~~被删除的文本~~ |
这是一个 |
任务列表
列表具有以下格式
1 | - [x] 任务 1 |
任务 1
任务 2
任务 3
Hexo 标签插件
Hexo 标签插件是一种快速项帖子添加特定内容的有用方法
引用快
1 | {% blockquote [author[, source]] [link] [source_link_title] %} |
示例
普通引用
1 | {% blockquote %} |
正因生来一无所有，因此能够拥有一切
引用书上的句子
1 | {% blockquote 马尔克斯, 百年孤独 %} |
生命中真正重要的不是你遭遇了什么，而是你记住了哪些事，又是如何铭记的
引用网络上的文章
1 | {% blockquote Mojang AB https://www.minecraft.net/zh-hans/about-minecraft %} |
在 Minecraft 中，每次游玩都有不同体验，世界各处都蕴藏着让人难以忘怀的冒险。在无限世界中探索创造，一步一个方块，这个世界任你塑造
1 | {% blockquote Mojang AB https://www.minecraft.net/zh-hans/about-minecraft Minecraft 是什么？ %} |
在 Minecraft 中，每次游玩都有不同体验，世界各处都蕴藏着让人难以忘怀的冒险。在无限世界中探索创造，一步一个方块，这个世界任你塑造
代码块
1 | {% codeblock [title] [lang:language] [url] [link text] [additional options] %} |
| 额外选项 | 描述 | 默认值 |
|---|---|---|
line_number |
显示行号 | true |
line_threshold |
只有代码块的行数超过该阈值，才显示行数 | 0 |
highlight |
启用代码高亮 | true |
first_line |
指定第一个行号 | 1 |
mark |
突出显示特定的行，每个值用逗号分隔。 使用破折号指定数字范围 例如： mark:1,4-7,10 将标记第 1、4 至 7 和 10 行 |
|
warp |
用 <table> 包裹代码块 |
true |
示例
普通代码块
1 | {% codeblock %} |
1 | print("Hello World") |
指定语言
1 | {% codeblock lang:python %} |
1 | print("Hello World") |
带标题和 URL
1 | {% codeblock .icon-pid https://tigsrk.cn/css/style.css iconfont.styl %} |
1 | .icon-pid |
带选中行
1 | {% codeblock mark:1,3-4 %} |
1 | .icon-pid |
Pull Quote
1 | {% pullquote [class] %} |
可选值有 left 和 right
示例
左 Pull Quote
1 | {% pullquote left %} |
购买 Minecraft：Java 和 Bedrock 版，一次购买即可获得两个版本的游戏。你可以使用一个启动器轻松地在 Java 版和 Bedrock 版之间切换，并与任何拥有 Minecraft 现有版本的玩家一起畅玩。
在这款终极沙盒游戏中建造出你能想到的所有奇景，揭开诡异秘事的神秘面纱，并在漫漫长夜中生存下来。在 Minecraft 中，每次游玩都有不同体验，世界各处都蕴藏着让人难以忘怀的冒险。在无限世界中探索创造，一步一个方块，这个世界任你塑造。经典 Minecraft 旅程往往从痛击树木收集木头开始。接下来的步骤就任你选择啦，采掘珍稀矿石或搜寻珍贵材料都可以。但是要确保你的食物储备充足！太阳西沉，敌对生物比比皆是。直面它们，还是安睡度过长夜？请牢记：地下总是一片漆黑……制作工具，搭建简陋居所，或是在你的基地部署红石科技。可以在 Nether 建造基地吗？只有一种方法能找出答案。对大胆勇毅的冒险者而言，没有什么是比打败危险生物、探索让人目不暇接的景色并在生存模式中以自己的方式取胜更好的选择了。
右 Pull Quote
1 | {% pullquote right %} |
购买 Minecraft：Java 和 Bedrock 版，一次购买即可获得两个版本的游戏。你可以使用一个启动器轻松地在 Java 版和 Bedrock 版之间切换，并与任何拥有 Minecraft 现有版本的玩家一起畅玩。
在这款终极沙盒游戏中建造出你能想到的所有奇景，揭开诡异秘事的神秘面纱，并在漫漫长夜中生存下来。在 Minecraft 中，每次游玩都有不同体验，世界各处都蕴藏着让人难以忘怀的冒险。在无限世界中探索创造，一步一个方块，这个世界任你塑造。经典 Minecraft 旅程往往从痛击树木收集木头开始。接下来的步骤就任你选择啦，采掘珍稀矿石或搜寻珍贵材料都可以。但是要确保你的食物储备充足！太阳西沉，敌对生物比比皆是。直面它们，还是安睡度过长夜？请牢记：地下总是一片漆黑……制作工具，搭建简陋居所，或是在你的基地部署红石科技。可以在 Nether 建造基地吗？只有一种方法能找出答案。对大胆勇毅的冒险者而言，没有什么是比打败危险生物、探索让人目不暇接的景色并在生存模式中以自己的方式取胜更好的选择了。
图像
1 | {% img [class names] /path/to/image [width] [height] '"title text" "alt text"' %} |
Reimu 主题标签插件
链接
Hexo.Reimu v0.2.0 添加了内链/外链的插件
1 | {% postLinkCard slug [cover]|"auto" [escape] %} # 内链 |
例：
1 | {% postLinkCard hexo auto %} |
1 | {% externalLinkCard "GitHub: Let’s build from here" https://github.com https://github.githubassets.com/assets/apple-touch-icon-144x144-b882e354c005.png %} |
友链标签插件
一种特殊的外链插件
1 | {% friendsLink filepath %} |
例：
1 | {% friendsLink about/_data.yml %} |
1 | - name: osu! |
博客书写规范
排版
| 操作 | 建议 | 不建议 |
|---|---|---|
| 标题不超过四级 | ## H2 ### H3 #### H4 |
## H2 ### H3 #### H4 ##### H5 |
| 标题不应跳级 | ## H2 ### H3 |
## H2 #### H4 |
| 标题不应冗长 | Markdown 的书写格式 | 不同元素在 Markdown 下的书写格式 |
| 使用有逻辑层次的结构 | 前言 内容 致谢 |
逻辑层次不强的结构 |
盘古之白
| 操作 | 建议 | 不建议 |
|---|---|---|
| 中英文之间应添加空格 | 这是一部 iPhone | 这是一部iPhone |
| 中文与数字之间应添加空格 | 2017 年 3 月 14 日 | 2017年3月14日 |
| 数字与英文单位之间不添加空格 | 我家的带宽为 1Gbps | 我家的带宽为 1 Gbps |
| 数字与度/百分比之间不添加空格 | 今天 24℃ | 今天 24 ℃ |
| 链接与前后文之间应添加空格 | 点击 这里 进行刷新 | 点击这里进行刷新 |
| 专用名词使用官方格式 | 豆瓣FM | 豆瓣 FM |
标点符号
| 操作 | 建议 | 不建议 |
|---|---|---|
| 中文使用全角符号 | 你好，世界 | 你好,世界 |
| 英文使用半角符号 | Hello, world | Hello，world |
| 中英混杂使用全角符号 | 买了新 iPhone，好开心 | 买了新 iPhone, 好开心 |
| 引号使用「」 | 如何不陷入「信息茧房」 | 如何不陷入“信息茧房” |
其他杂项：
- 英文标点后添加空格
- 中文书写时，括号中包括数字时使用半角符号，并在括号外留一个空格（连续两个标点时除外），如：全部联系人(12)
- 尽量用
blockqoute代替 「！」 和 「！！」
遣词造句
| 操作 | 建议 | 不建议 |
|---|---|---|
| 正确书写专有名词 | ChatGPT | Chatgpt |
| 不使用不地道缩写 | HTML5 | h5 |
| 特写名词不强行翻译 | NBA | 北美职业篮球联赛 |
