文章模板：Markdown 语法 + 安知鱼标签插件速查

一、Markdown 基础语法

1.1 标题与段落

用 # 的数量表示一到六级标题；段落之间空一行；行尾加两个空格或回车两次换行。

1.2 文字样式

斜体 或 斜体，加粗，粗斜体，删除线，行内代码，==高亮==（部分渲染器支持）。

引用块。可以嵌套：

二级引用。

1.3 列表

  • 无序列表项 A
  • 无序列表项 B
    • 缩进两个空格是子项
  1. 有序列表第一项
  2. 有序列表第二项
  • 未完成的任务
  • 已完成的任务

1.4 链接与图片

文字链接，图片：

1
![图片描述](/img/example.jpg)

1.5 表格

功能 语法 说明
左对齐 :--- 默认
居中 :---: 居中
右对齐 ---: 右对齐

1.6 代码块

1
2
3
// 三个反引号 + 语言标识，安知鱼会自动开启代码高亮
const hello = () => console.log("Hello Hexo");
hello();
1
hexo clean && hexo g && hexo s

二、Markdown 进阶用法

2.1 摘要分割

在正文中插入 <!-- more -->，其上方内容作为首页摘要。

2.2 脚注

安知鱼支持脚注语法。这是一段正文^note1，再来一段^note2。

2.3 数学公式（需开启 math: true）

行内公式：质能方程 $E = mc^2$

块级公式：

$$
\int_{-\infty}^{\infty} e^{-x^2} , dx = \sqrt{\pi}
$$

2.4 mermaid 图表（需主题配置 mermaid.enable: true）

2.5 上标下标与转义

  • 上标下标可用 HTML：H2O，x2
  • 反斜杠转义特殊字符：*这不是斜体*，# 不是标题

三、安知鱼标签插件（Tag Plugins）

标签插件是安知鱼特有的增强格式，写法为 {% 标签名 参数 %}，成对的以 {% endxxx %} 结束。

3.1 Note 提示块（最常用）

default 提示块

primary 提示块

success 提示块

info 提示块

warning 提示块

danger 提示块（无图标）

另一种配色写法：

自定义图标 + 颜色

提示块的整体风格可在主题配置 note.style 中设置：simple / modern / flat / disabled。

3.2 Tip 上标标签

default

info

success

warning

error

bell

3.3 Label 行内标签

臣亮言：先帝 创业未半，而中道崩殂 ，此诚危急存亡之秋 也！

颜色可选：default / blue / pink / red / purple / orange / green。

3.4 彩色文字 p / span

红色

、

黄色

、

绿色

、

青色

、

蓝色

、

灰色

行内同理：红色 与

3.5 行内文本样式

带 下划线 的文本、带 着重号 的文本、带 波浪线 的文本、带 删除线 的文本、键盘样式 Ctrl + C、密码样式 这是隐藏内容。

3.6 折叠框 folding

查看折叠内容

这里的内容默认收起，点击标题展开。可以放图片、代码块等任何内容。

默认打开的折叠框

加 open 参数则默认展开。颜色可选：blue / cyan / green / yellow / red。

3.7 隐藏内容 tag-hide

行内隐藏（适合做问答）：哪个英文字母最酷？ 因为西装裤(C装酷)

块级隐藏：

这里可以放大段内容，包括图片和代码块。

收缩框：

点击展开收缩框

内容与 hideBlock 类似，样式略有不同。

注意：hide 类标签内容中不建议放 h1-h6 标题，否则 Toc 目录滚动会异常。

3.8 Tabs 分栏

1
git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu
1
theme: anzhiyu
1
hexo clean && hexo g && hexo s

3.9 按钮 btn / btns

查看文档 主题仓库 按钮组：
安知鱼文档 主题仓库
引用站外地址
favicon
安知鱼主题官方文档
一个简洁、美丽的静态 Hexo 主题
示例图片
示例图片

行内图片：这是 一段话。

3.12 音频 audio / 视频 video

多视频分栏（1~4 列）用 `
...
` 包裹。

3.13 时间线 timeline

我的建站历程

2026-08-07

搭建 Hexo，安装安知鱼主题。

2026-08-08

写下第一篇文章。

3.14 单选 radio / 复选 checkbox

安知鱼

Butterfly

已完成安装

还没写第一篇文章

新增

删除

3.15 友链 flink（一般用在友链页面）

1
2
3
4
5
6
7
8
9
{% flink %}
- class_name: 推荐博客
  flink_style: flexcard
  link_list:
    - name: 安知鱼
      link: https://blog.anheyu.com/
      avatar: 头像链接
      descr: 生活明朗，万物可爱
{% endflink %}

四、使用注意事项

  1. 转义问题：正文中想显示 {% ... %} 原文时，用代码块包住（如本文 flink 示例），否则会被当标签解析报错。
  2. hide 标签：content 中不能含英文逗号，可用 &sbquo; 代替。
  3. top_img：只能写图片路径或 false，裸 true 会导致渲染报错 top_img.indexOf is not a function。
  4. 改完先清缓存：hexo clean && hexo g && hexo s。
  5. 更多标签：完整 25 个标签插件见官方示例页：https://hexo.anheyu.com/posts/d50a.html

参考