标签插件总览

所有标签插件在 Markdown 正文中直接使用，不需要安装任何插件——它们由主题的 scripts/tags/index.js 注册。

语法索引

通用约定

参数分隔

大部分插件用逗号切分参数，且会自动去掉首尾引号：

1
2

{% raw %}{% button /archives/, 查看归档, archive, outline %}{% endraw %}
        └─ 1 ────────┘└─ 2 ────┘└─ 3 ──┘└─ 4 ──┘

note、label 这类使用 toList() 解析的插件，逗号和空格都算分隔符，因此下面两种写法等价：

1
2

{% raw %}{% label primary 新特性 %}{% endraw %}
{% raw %}{% label primary, 新特性 %}{% endraw %}

内容渲染

标签体内的内容会尽量按 Markdown 渲染。若标签体以块级 HTML 标签开头（如 <p> <div> <table> <ul>），则原样保留不重复渲染。

1
2
3
4
5
6

{% raw %}{% note tip 支持 Markdown %}
这里可以写 **加粗**、`行内代码`、[链接](/)。

- 列表项一
- 列表项二
{% endnote %}{% endraw %}

嵌套

插件可以嵌套使用，但同类型插件不要交叉嵌套（如 tabs 里再放 tabs），因为渲染依赖一个内部栈，交叉嵌套会导致内容错位。

1
2
3
4
5
6
7
8
9
10

{% raw %}{% row %}
{% col 6 %}
{% note info 左边 %}
栅格内可以放提示块。
{% endnote %}
{% endcol %}
{% col 6 %}
支持嵌套组合。
{% endcol %}
{% endrow %}{% endraw %}

分页索引

写在哪

标签插件可以在任何 Markdown 内容里使用：

• 文章（source/_posts/）
• 页面（source/xxx/index.md）
• 甚至是 source/_data/ 之外的 YAML 值中不行——标签只在 Markdown 渲染阶段解析