Markdown 与富文本用法示例

这是一篇自用的语法速查，覆盖这个博客（Hexo +
Stellar 主题）实际支持的排版能力。
写文章时对照抄即可，不确定效果的部分都给了可运行的例子。

发布新文章

标准 Hexo 流程是四条命令：

1
2
3
4
5
6
7
8
9
10
11

# 1. 新建文章
hexo new "我的新文章"

# 2. 本地预览
hexo server

# 3. 生成静态文件
hexo generate

# 4. 部署
hexo deploy

命令细节见 Hexo 命令文档，
文章写法见 写作文档。

本仓库在此基础上用脚本封装了常用操作：

1
2
3
4
5
6
7
8
9
10
11

# 新建草稿（不进构建产物，可本地预览）
pnpm run draft "文章标题"

# 本地预览，带草稿
pnpm run server:drafts

# 构建（输出到 public）
pnpm run build

# 部署到本机 IIS 预览
pnpm run deploy:iis

发布流程：把 _drafts/ 下的 .md 和同名资源文件夹一起移到 source/_posts/，
然后提交并推送——推送后由 Cloudflare Pages 自动构建发布。

文章的日期决定固定链接，格式是 /年/月/日/文件名/；改文件名等于改链接，
已有评论会跟着旧链接走，改名要谨慎。

标题层级

一级标题由文章标题自动生成，正文里从二级开始用：

1
2
3
4
5

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

效果对照

四级标题示例

五级标题示例

六级标题示例

文本样式

粗体、斜体、粗斜体、删除线、行内代码。

转义特殊字符：*这不是斜体*。

需要强调时也可以用标签：

链接

行内链接、站内链接与引用式链接：

1
2
3
4
5

[Hexo 官网](https://hexo.io/)
[归档页](/archives/)
[本站归档][archives]

[archives]: /archives/

效果：Hexo 官网、归档页、本站归档。

自动链接：https://hexo.io/docs/。

列表

无序列表：

• 第一项
• 第二项
  • 嵌套项
  • 另一个嵌套项
• 第三项

有序列表：

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

任务列表（GFM 规范）：

• 已完成的任务
• 未完成的任务

也可以改用主题标签，支持颜色与图标：

引用

普通引用：

这是一段引用文字。

引用里可以换段，也可以包含 加粗 和 代码。

带样式的引用块：

提示块

note 标签支持 8 种颜色（red / orange / yellow / green / cyan / blue / purple / gray）：

tip 是悬停气泡：把鼠标移到这段文字这是气泡里显示的注解上看看。

折叠块

1

console.log('折叠块里的代码');

代码

行内代码用反引号：npm install。

围栏代码块会由 highlight.js 高亮，显示行号与语言，
右上角有复制按钮：

1
2
3
4
5
6
7
8
9

// JavaScript 示例：把数组按长度分组
const groupBy = (list, size) =>
  list.reduce((acc, item, index) => {
    const bucket = Math.floor(index / size);
    (acc[bucket] ||= []).push(item);
    return acc;
  }, []);

console.log(groupBy([1, 2, 3, 4, 5], 2));

1
2
3
4
5

# Python 示例：统计词频
from collections import Counter

text = "to be or not to be that is the question"
print(Counter(text.split()).most_common(3))

1
2
3
4

# Shell 示例
pnpm install
pnpm run build
pnpm run deploy:iis

还有行内复制按钮：

表格

普通 Markdown 表格：

内容较长时用 table 标签包裹，可横向滚动：

图片与媒体

单张图片（点击可放大，灯箱用的是 Fancybox）：

指定宽度的图片（image 标签）：

演示图片二

图集（gallery 标签，支持 layout:grid 或 layout:flow、size、aspect_ratio）：

演示图片一

演示图片二

演示图片三

视频与音频标签需要真实媒体文件，语法见文末速查。

数学公式

公式由 KaTeX 在构建时渲染成静态 HTML。

行内公式：质能方程 $E = mc^2$，欧拉恒等式 $e^{i\pi} + 1 = 0$。

行间（块级）公式：

选项卡

1

console.log('标签页里的代码');

时间线

多列网格

表情与图标

系统 Unicode 表情可以直接用：😀 🎉 ✅ 🚀，由系统字体渲染，不需要额外资源。

主题还提供 emoji 与 icon 标签（emoji 依赖外部图床，加载可能不稳定，故此处不演示）：

语法速查

以下是主题注册的全部标签（共 45 个），参数细节见
Stellar 标签文档。

目前未启用的能力

• Mermaid 图表：需要额外安装渲染插件，并在主题配置里把
  features.diagrams.provider 设为 mermaid，详见
  Mermaid 官网。
• 评分 / 投票：依赖外部评分服务地址，当前为空。
• GitHub 卡片：需要可用的接口地址。

评论区支持的格式

评论区由 Twikoo 提供，支持以下写法（与正文语法略有不同）：

• Markdown：粗体、斜体、删除线、行内代码、代码块（带语言高亮）、
  列表、引用、链接、表格
• 数学公式：行内用单个美元符号，块级用双美元符号，浏览器端渲染
• 表情：面板里的 OwO 表情，会以冒号包裹的名称插入
• 图片：选择或直接粘贴上传，存储在自己的对象存储里
• 其他：草稿本地保存、预览、楼中楼回复、点赞、快捷键发送、人机验证

正文的公式用 katex 标签（构建时渲染），评论区的公式用美元符号（运行时渲染），
两者不要混用。