写文章时的速查表。每种语法都先给写法、再给实际效果。示例里的 Hexo 标签用 raw 标签包住,避免这篇笔记自己被执行;「效果」部分是真实渲染。
一、Markdown 基础
标题
1 | # 一级标题 |
文章标题由 front-matter 的
title渲染,正文里别再写一级标题。本页的各级标题就是效果。
强调
1 | **粗体** *斜体* ~~删除线~~ `行内代码` |
效果:粗体 斜体 删除线 行内代码
链接
1 | [显示文字](https://example.com) |
站内链接用绝对路径:
1 | [关于我](/about/) |
效果:关于我 文章库的 CTF 标签
引用式(URL 长或多次使用):
1 | 见 [官方文档][bf]。 |
效果:见 官方文档。
图片
1 |  |
效果:
图片放 source/images/ 或 source/img/。正文里写相对路径 ../images/...、../img/...
(文章都在 source/_posts/,所以相对路径指向 source/images/),渲染时 scripts/img-path.js
会自动改回站内绝对路径 —— 这样 VSCode 的 Markdown 预览也能看到图。
例外:front-matter 的 cover、avatar 这类配置项不走 Markdown 渲染,必须写 /images/... 绝对路径。
多图并排:连续写多张图(中间不空行)会自动排成两列;想单列大图就在两张图之间空一行。
列表
1 | - 无序 |
效果:
- 无序
- 列表
- 有序
- 列表
- [ ] 待办
- [x] 已完成
代码
1 | `行内代码` |
效果:行内代码
1 | print('hello') |
表格
1 | | 列 1 | 列 2 | |
效果:
| 列 1 | 列 2 |
|---|---|
| a | b |
引用与分割线
1 | > 引用内容 |
效果:
引用内容
数学公式
front-matter 加 katex: true,然后:
1 | 行内:$a^2 + b^2 = c^2$ |
效果:行内
二、Butterfly 标签
提示框 note
写法:
1 | {% note warning %} |
效果:
这里是警告
modern 样式(在 note 标签里加 modern):
现代样式的提示框
类型:default / primary / info / success / warning / danger。
折叠 hideToggle / hideBlock / hideInline
写法:
1 | {% hideToggle 点开看答案 %} |
效果:
点开看答案
折叠起来的内容
行内:
选项卡 tabs
写法:
1 | {% tabs 演示 %} |
效果:
这是第一个标签页的内容。
标签 label
写法:
```markdown {% label 绿色 green %} ```效果:绿色 蓝色 警告
颜色:default / blue / pink / red / purple / orange / green。
按钮 button
写法:
```markdown {% btn 'https://example.com', '点我', 'fas fa-link' %} ```效果:点我
时间轴 timeline
写法:
1 | {% timeline 2026 %} |
效果:
2026
10-01
做了什么
友链卡片 flink
里面的内容是一段 YAML,不是 Markdown 列表:
```markdown {% flink %} - class_name: 示例分组 class_desc: 卡片说明 link_list: - name: Everforest link: https://github.com/sainnhe/everforest avatar: /img/everforest.png descr: 本站配色的源头 {% endflink %} ```效果:
相册 gallery
写法:
```markdown {% gallery %}   {% endgallery %} ```效果:
行内图片 inlineImg
写法:
```markdown {% inlineImg ../img/cloud.jpg 80px %} ```效果:
系列文章 series
写法:
```markdown {% series %} {% series 数学分析 %} ```效果(当前没有 series 字段的文章,所以是空的):
按文章的
series字段分组,文章多了以后会自动列出。
Mermaid 流程图
需要先在 _config.butterfly.yml 打开 mermaid.enable,当前是关闭的:
1 | {% mermaid %} |
效果(配置关闭时不显示):
graph TD
A --> B
三、Hexo 内置标签
代码块 codeblock
写法与效果:
1 | print('带文件名的代码块') |
引用 quote
这是引用内容,和 Markdown 的
>类似,但可以带出处。
iframe / youtube
1 | {% iframe https://example.com 100% 400 %} |
这两个会嵌入外部页面/视频,需要真实链接才有内容,这里不演示。
四、front-matter 常用字段
1 |
|
五、几个容易踩的坑
- 示例里的 Hexo 标签必须包在 raw 标签里,否则会被真的执行(连行内代码里的也会)。
- 站内链接一律用
/...绝对路径,别用相对路径。 - 图片路径用相对写法
../images/...、../img/...(渲染时自动转成绝对路径,VSCode 预览也能看图);
只有 front-matter 的cover必须写绝对/images/...。 - 数学公式要在 front-matter 写
katex: true。 - 改完文章记得在管理页点「保存」,再点「发布」才会推到线上。