写文章时的速查表。每种语法都先给写法、再给实际效果。示例里的 Hexo 标签用 raw 标签包住,避免这篇笔记自己被执行;「效果」部分是真实渲染。

一、Markdown 基础

标题

1
2
3
# 一级标题
## 二级标题
### 三级标题

文章标题由 front-matter 的 title 渲染,正文里别再写一级标题。本页的各级标题就是效果。

强调

1
**粗体**  *斜体*  ~~删除线~~  `行内代码`

效果:粗体 斜体 删除线 行内代码

链接

1
2
[显示文字](https://example.com)
[带提示](https://example.com "悬停文字")

效果:显示文字 带提示

站内链接用绝对路径:

1
2
[关于我](/about/)
[文章库的 CTF 标签](/library/?tag=CTF)

效果:关于我 文章库的 CTF 标签

引用式(URL 长或多次使用):

1
2
3
见 [官方文档][bf]。

[bf]: https://butterfly.js.org/

效果:见 官方文档。

图片

1
![描述](../images/tsctf2026/image-1.png)

效果:

描述

图片放 source/images/ 或 source/img/。正文里写相对路径 ../images/...、../img/...
(文章都在 source/_posts/,所以相对路径指向 source/images/),渲染时 scripts/img-path.js
会自动改回站内绝对路径 —— 这样 VSCode 的 Markdown 预览也能看到图。

例外:front-matter 的 cover、avatar 这类配置项不走 Markdown 渲染,必须写 /images/... 绝对路径。

多图并排:连续写多张图(中间不空行)会自动排成两列;想单列大图就在两张图之间空一行。

列表

1
2
3
4
5
6
7
8
- 无序
- 列表

1. 有序
2. 列表

- [ ] 待办
- [x] 已完成

效果:

  • 无序
  • 列表
  1. 有序
  2. 列表
  • [ ] 待办
  • [x] 已完成

代码

1
2
3
4
5
`行内代码`

```python
print('hello')
```

效果:行内代码

1
print('hello')

表格

1
2
3
| 列 1 | 列 2 |
|---|---|
| a | b |

效果:

列 1 列 2
a b

引用与分割线

1
2
3
> 引用内容

---

效果:

引用内容


数学公式

front-matter 加 katex: true,然后:

1
2
3
4
5
6
行内:$a^2 + b^2 = c^2$

块级:
$$
c \equiv m^e \pmod n
$$

效果:行内 a2+b2=c2a^2 + b^2 = c^2

c≡me(modn)c \equiv m^e \pmod n

二、Butterfly 标签

提示框 note

写法:

1
2
3
{% note warning %}
这里是警告
{% endnote %}

效果:

这里是警告

modern 样式(在 note 标签里加 modern):

现代样式的提示框

类型:default / primary / info / success / warning / danger。

折叠 hideToggle / hideBlock / hideInline

写法:

1
2
3
4
5
6
7
8
9
{% hideToggle 点开看答案 %}
折叠起来的内容
{% endhideToggle %}

{% hideBlock 点击展开 %}
块级内容
{% endhideBlock %}

{% hideInline 藏起来的内容, 点我 %}

效果:

点开看答案

折叠起来的内容

块级内容

行内:藏起来的内容

选项卡 tabs

写法:

1
2
3
4
5
6
7
8
{% tabs 演示 %}
<!-- tab 第一个 -->
内容一
<!-- endtab -->
<!-- tab 第二个 -->
内容二
<!-- endtab -->
{% endtabs %}

效果:

这是第一个标签页的内容。

标签 label

写法:

```markdown {% label 绿色 green %} ```

效果:绿色 蓝色 警告

颜色:default / blue / pink / red / purple / orange / green。

按钮 button

写法:

```markdown {% btn 'https://example.com', '点我', 'fas fa-link' %} ```

效果:点我

时间轴 timeline

写法:

1
2
3
4
5
6
7
8
{% timeline 2026 %}
<!-- timeline 10-01 -->
做了什么
<!-- endtimeline -->
<!-- timeline 10-20 -->
又做了什么
<!-- endtimeline -->
{% endtimeline %}

效果:

2026

10-01

做了什么

里面的内容是一段 YAML,不是 Markdown 列表:

```markdown {% flink %} - class_name: 示例分组 class_desc: 卡片说明 link_list: - name: Everforest link: https://github.com/sainnhe/everforest avatar: /img/everforest.png descr: 本站配色的源头 {% endflink %} ```

效果:

写法:

```markdown {% gallery %} ![图一](../images/tsctf2026/image-1.png) ![图二](../images/tsctf2026/image-2.png) {% endgallery %} ```

效果:

行内图片 inlineImg

写法:

```markdown {% inlineImg ../img/cloud.jpg 80px %} ```

效果:

系列文章 series

写法:

```markdown {% series %} {% series 数学分析 %} ```

效果(当前没有 series 字段的文章,所以是空的):

按文章的 series 字段分组,文章多了以后会自动列出。

Mermaid 流程图

需要先在 _config.butterfly.yml 打开 mermaid.enable,当前是关闭的:

1
2
3
4
{% mermaid %}
graph TD
A --> B
{% endmermaid %}

效果(配置关闭时不显示):

三、Hexo 内置标签

代码块 codeblock

写法与效果:

1
print('带文件名的代码块')

引用 quote

这是引用内容,和 Markdown 的 > 类似,但可以带出处。

iframe / youtube

1
2
3
{% iframe https://example.com 100% 400 %}

{% youtube 视频id %}

这两个会嵌入外部页面/视频,需要真实链接才有内容,这里不演示。

四、front-matter 常用字段

1
2
3
4
5
6
7
8
9
10
11
12
13
---
title: 文章标题
date: 2026-10-23 22:30:00
description: 首页卡片和文章头部的简介
tags: [CTF, WriteUp]
categories: [CTF]
katex: true # 需要数学公式
type: note # 笔记;不写就是普通文章
top: true # 置顶
cover: /images/xxx.png
top_img: false # 关掉文章页横幅
series: 数学分析 # 系列文章
---

五、几个容易踩的坑

  1. 示例里的 Hexo 标签必须包在 raw 标签里,否则会被真的执行(连行内代码里的也会)。
  2. 站内链接一律用 /... 绝对路径,别用相对路径。
  3. 图片路径用相对写法 ../images/...、../img/...(渲染时自动转成绝对路径,VSCode 预览也能看图);
    只有 front-matter 的 cover 必须写绝对 /images/...。
  4. 数学公式要在 front-matter 写 katex: true。
  5. 改完文章记得在管理页点「保存」,再点「发布」才会推到线上。