下列内容来自 Gemini AI ，可能有错误内容，请注意甄别

以下是基于 LiuShen 主题源码整理的外挂标签（Tag Plugins）使用手册。

下列所有的外挂标签均为LiuShen主题默认可用的

Link 卡片

用于生成带有站点图标、标题和安全提示的链接卡片。

格式

Markdown

1	{% link 标题, 站点名, 链接 %}

示例

🪧引用站外地址，不保证站点的可用性和安全性

docker-compose.yml

Mai-with-u@MaiBot

便签 (Note)

用于展示不同风格的提示信息框，支持多种颜色和图标。

格式

1
2
3

{% note [style] [icon] %}
内容（支持 Markdown）
{% endnote %}

style: 可选 flat (扁平), modern (现代), simple (简单), disabled (禁用)。
icon: 可选 Font Awesome 图标类名（如 fa-solid fa-bullhorn）。

示例

这是一个现代风格的射线枪图标便签。

带标题的标签

1
2
3

{% note 样式 图标, 标题 %}
内容（支持 Markdown）
{% endnote %}

test

按钮 (Button)

生成美化的超链接按钮。

格式

1	{% btn 链接, 文字, 图标, 选项 %}

选项: 可组合使用 color (blue/pink/red/purple/orange/green), outline, center, block, larger。

示例

GitHub

文本标签 (Label)

为行内文字添加着色背景。

格式

Markdown

1	{% label 文字, 颜色 %}

颜色: 可选 default, blue, pink, red, purple, orange, green。

示例

这是一段重点关注, 的文字。

时间线 (Timeline)

以垂直时间轴的形式展示内容。

格式

1
2
3

{% timeline 标题, 颜色 %}
子节点内容
{% endtimeline %}

示例

项目进度

选项卡 (Tabs)

在一个容器内切换展示多块内容。

格式

{% tabs 组名, [默认激活索引] %}
内容（支持 Markdown，如图片、文字等）
内容1
{% endtabs %}

示例

内容隐藏 (Hide)

提供行内、块级或折叠面板样式的隐藏内容功能。

格式

1
2
3

{% hideInline 内容, 按钮文本, 背景色, 文字颜色 %}
{% hideBlock 按钮文本, 背景色, 文字颜色 %} 内容 {% endhideBlock %}
{% hideToggle 标题, 背景色, 文字颜色 %} 内容 {% endhideToggle %}

示例（此处展示的hideToggle类型）

点击查看答案

这里的隐藏内容被成功揭晓了。

聊天对话框 (Chat)

模拟社交软件的聊天记录界面。

格式

{% chatBox 标题 %}
{% chat 姓名, 内容 %}
{% chat me, 内容 %}
{% chat 姓名@QQ号, 内容 %}
{% endchatBox %}

使用 me 会自动调用博主头像；使用 @QQ号 会自动抓取 QQ 头像。

示例

示例消息

FouC3

示例消息

图库 (Gallery)

用于展示单组图片或相册集合。

格式

{% gallery [button] %}
![alt](url)
{% endgallery %}

{% galleryGroup 名字, 描述, 链接, 封面图 %}

示例

友情链接 (Flink)

以列表形式展示友情链接，支持 YAML 格式配置。

格式

{% flink %}
- class_name: 技术大牛
  class_desc: 值得学习的博客
  link_list:
    - name: 示例站点
      link: https://example.com
      avatar: https://example.com/avatar.png
      descr: 这是一个站点描述
{% endflink %}

示例

友情链接

hexo-theme-liushen

LiuShen

一个基于 Butterfly 的定制化主题

系列文章 (Series)

自动生成当前所属系列的其他文章列表。

格式

1	{% series [系列名称] %}

若不填名称，则自动寻找 Front-matter 中定义的 series 属性。

示例

其它功能标签

行内图片: {% inlineImg 图片链接, 高度 %}
Mermaid: {% mermaid %} 流程图代码 {% endmermaid %}
乐谱: {% score %} ABC记谱法代码 {% endscore %}

hexo-theme-liushen外挂标签