markdown写作常用标识

📋 知识地图

说明：✅ = 已有覆盖　⬜ = 待扩充

1.基础语法（已全覆盖）

  • ✅ 标题（# 1-6级 / === / —）
  • ✅ 段落与换行
  • ✅ 字体效果（斜体 / 粗体 / 粗斜体）
  • ✅ 分割线
  • ✅ 删除线与下划线
  • ✅ 脚注（数字格式）
  • ✅ 有序列表与无序列表（含嵌套）
  • ✅ 区块引用（>）
  • ✅ 代码片段与代码块（含语言标注）
  • ✅ 外部链接与图片
  • ✅ 表格（含对齐与宽度控制）
  • ✅ 转义符（\）
  • ✅ HTML 隐藏注释
  • ✅ 锚点跳转（本文内 / 站内文章）

2.HTML 内联标签（Hexo 支持）

  • ✅ 悬停提示（abbr）
  • ✅ 折叠块（details / summary）
  • ✅ 上标与下标（sup / sub）
  • ✅ 高亮标记（mark）
  • ✅ 键盘按键（kbd）

3.Markdown 扩展语法

  • ✅ 任务列表（- [ ] / - [x]）
  • ⬜ Mermaid 图表（流程图 / 时序图 / 甘特图）
  • ⬜ 数学公式（LaTeX / MathJax）
  • ⬜ 定义列表（dt / dd）

4.Hexo 博客写作深度集成

  • ✅ Hexo 内部链接（post_link / post_path）
  • ⬜ Hexo 标签插件大全（blockquote / code / note / iframe 等）
  • ⬜ Front-matter 完整字段

因为 hexo 下采用 markdown 排版进行写作，为了方便练习 markdown 写作，在这里记录写作中常用的 markdown 标识排版。

兼容性说明：本博客使用 hexo-renderer-marked（marked@0.7.0）渲染引擎。标准 Markdown 语法和行内 HTML 标签均可正常渲染。脚注通过自建脚本 scripts/footnotes-simple.js 处理，只支持数字格式 <sup id="fnref:1"><a href="#fn:1" rel="footnote">[1]</a></sup>，不支持命名格式 [^name]。

一、使用 # 标记标题

使用 # 的数量可标识 1-6 级的标题。

示例：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

另外，可使用一行（多个 = 或 -）分别标识一级标题和二级标题：

1
2
3
4
5
一级标题
=======

二级标题
-------

二、切换段落

Markdown 没有段落符号，可使用空行或在行末添加两个空格来换段落。

1
2
3
4
第一段文字（行末两个空格换行）
同一段的第二行

第二段（上方空行分隔）

三、添加粗体等字体效果

可以分别用一个、两个以及三个 * 或 _ 标识符框住文字前后，来为文字添加效果。

示例：

1
2
3
*斜体*
**粗体**
***粗斜体***

效果： 斜体 / 粗体 / 粗斜体

四、建立分割线

使用三个以上的 *、- 建立分割线。

1
2
---
***

五、删除线

使用两个波浪线 ~~ 框住文字前后，产生删除线。

1
~~删除线~~

六、下划线

Markdown 没有原生下划线语法，通过 HTML <u> 标签实现。

1
<u>下划线</u>

效果： 下划线

七、使用脚注

脚注用于在文末添加补充说明，点击上标数字可跳转到对应注释。

⚠️ 重要：本博客脚注只支持数字格式，不支持命名格式。

写法：

1
2
3
正文里引用脚注[1]，继续写。

[^1]: 脚注内容写这里。

效果：

正文里引用脚注[1]，继续写。

规则：

  • [^数字] 引用 + [^数字]: 定义，数字必须配对
  • 定义放哪都行，通常放文末
  • 不要写没有定义的引用（会导致构建报错）
  • 不要用 [^字母] 命名格式（本博客不支持）

八、使用列表

支持有序列表和无序列表，列表可嵌套。

无序列表

无序列表使用 *、+ 或 - 开头：

1
2
3
- 第一项
- 第二项
- 第三项

效果：

  • 第一项
  • 第二项
  • 第三项

有序列表

有序列表使用数字加 . 开头：

1
2
3
1. 第一项
2. 第二项
3. 第三项

效果：

  1. 第一项
  2. 第二项
  3. 第三项

列表嵌套

在次级列表前方添加四个空格即可嵌套：

1
2
3
4
5
6
1. 有序列表一
    - 无序列表一
    - 无序列表二
2. 有序列表二
    - 无序列表三
    - 无序列表四

效果：

  1. 有序列表一
    • 无序列表一
    • 无序列表二
  2. 有序列表二
    • 无序列表三
    • 无序列表四

任务列表

使用 - [ ] 和 - [x] 创建带复选框的任务列表。

1
2
3
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个未完成任务

效果：

  • 已完成的任务
  • 未完成的任务
  • 另一个未完成任务

九、生成区块引用

使用 > 生成引用区块，可根据符号数量嵌套。

1
2
3
> 区块一
> 区块一
>> 区块二（嵌套）

效果：

区块一
区块一

区块二（嵌套）

十、代码

代码片段

使用反引号（英文输入法下，键盘左上角）标识行内代码。

1
使用 `console.log()` 输出内容。

效果： 使用 console.log() 输出内容。

代码区块

使用连续三个反引号包裹代码区块，可标注语言实现语法高亮：

1
2
3
4
5
```javascript
$(document).ready(function () {
    alert('RUNOOB');
});
```

效果：

1
2
3
$(document).ready(function () {
    alert('RUNOOB');
});

十一、外部链接

写法：

1
2
3
[链接名称](链接地址)
或
<链接地址>

示例： 这是一个链接 菜鸟教程

十二、插入图片

写法：

1
2
3
![alt 属性文本](图片地址)
或
![alt 属性文本](图片地址 "可选标题")

示例：

1
![御坂头像](https://example.com/avatar.png "御坂美琴")

十三、使用表格

写法：

1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果：

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

注意： 表格上一行要空一行，否则可能渲染失败。

强制列宽度：

1
2
3
4
5
<style>
table th:first-of-type {
    width: 30%;
}
</style>

十四、转义符号

使用反斜杠 \ 转义 Markdown 特殊字符（如 *、_、#、| 等），使其显示为普通文本。

1
2
\*这不是斜体\*
\| 这不是表格分隔符 \|

效果： *这不是斜体* | 这不是表格分隔符 |

十五、悬停提示（abbr）

使用 HTML <abbr> 标签，鼠标悬停时显示术语解释。适合对专业缩写词进行即时解释，不打断阅读。

写法：

1
<abbr title="Central Intelligence Agency，美国中央情报局">CIA</abbr>

效果： CIA

使用建议：

  • 术语首次出现时用 <abbr> 包裹，后续直接写缩写即可
  • title 属性内容不宜过长，一两句话为佳
  • 手机端可能无法悬停，重要信息建议同时用脚注或正文说明

十六、折叠块（details）

使用 HTML <details> 和 <summary> 标签创建可折叠区域。默认折叠，点击标题展开。适合放长段补充说明、操作步骤、深度扩展等内容。

写法：

1
2
3
4
5
6
7
8
<details>
<summary><b>📖 点击标题展开内容</b></summary>

这里写折叠的内容。

支持**Markdown 语法**和换行。

</details>

效果：

📖 点击标题展开内容

这里写折叠的内容。

支持Markdown 语法和换行。

使用建议：

  • <summary> 和内容之间留一个空行，确保 Markdown 语法正常渲染
  • 标题里可以用 <b> 加粗或加 emoji 增强可读性
  • 适合放：操作步骤、深度解释、参考表格、自测题等”可选阅读”内容

十七、上标与下标

Markdown 原生不支持上标下标，通过 HTML <sup> 和 <sub> 标签实现。

写法：

1
2
上标：X<sup>2</sup> + Y<sup>2</sup> = Z<sup>2</sup>
下标：H<sub>2</sub>O、CO<sub>2</sub>

效果：

  • 上标：X2 + Y2 = Z2
  • 下标：H2O、CO2

十八、高亮标记（mark）

使用 HTML <mark> 标签实现文字高亮（黄色背景），用于强调关键内容。

1
<mark>这段文字会被高亮</mark>

效果： 这段文字会被高亮

十九、键盘按键（kbd）

使用 HTML <kbd> 标签标识键盘按键，常用于教程和快捷键说明。

1
按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制，<kbd>Ctrl</kbd> + <kbd>V</kbd> 粘贴。

效果： 按 Ctrl + C 复制，Ctrl + V 粘贴。

二十、隐藏注释

使用 HTML 注释 <!-- --> 在文章中添加不可见的备注，渲染后不显示。

1
<!-- 这段内容不会在页面上显示 -->

二十一、跳转到锚点

本文内锚点

跳转到本文某个标题处，标题会自动生成 id（中文标题取原文，空格变连字符）：

1
[跳转到"二、切换段落"处](#二、切换段落)

效果： 跳转到”二、切换段落”处

站内其他文章

跳转到站内其他文章页面：

1
{% raw %}{% post_link 文章文件名（不要后缀） 文章标题（可选） %}{% endraw %}

例如跳转到御坂关于页面：

1
{% raw %}{% post_link 御坂引导 %}{% endraw %}

站内其他文章的特定锚点：

1
[外部显示文字]({% post_path '文章文件名' %}#某级标题)

二十二、更多资源

更多高级用法请参考：

  1. 1.这是一个脚注的示例内容。 ↩