tag 容器是一个自闭合组件,用于直接在文本中插入小巧的药丸状徽章。与块容器不同,标签不会继承父元素(如标题)的巨大尺寸,无论放置在哪里,它们都会保留紧凑、整洁的比例。

基本用法

要创建一个基本标签,只需提供你想要显示的文本:

预览
Markdown 源码

此功能已在 ::: tag “v0.7.4” color:blue 中添加,且运行完美。

此功能已在 ::: tag "v0.7.4" 中添加,且运行完美。

自定义颜色

你可以通过提供任何有效的 CSS 颜色字符串(例如 #ff0000bluehsl(...)),使用 color: 属性来覆盖默认的标签样式。docmd 会自动计算出精美的淡色背景,并配以对比完美的文本和边框!

::: tabs

== tab “预览”
::: tag “已弃用” color:#ef4444
::: tag “Beta” color:#eab308
::: tag “稳定版” color:#22c55e
== tab “Markdown 源码”

::: tag "已弃用" color:#ef4444
::: tag "Beta" color:#eab308
::: tag "稳定版" color:#22c55e

:::

添加图标

就像按钮和标注一样,你可以使用 icon: 属性轻松附加来自 docmd 图标库的图标。

::: tabs

== tab “预览”
::: tag “已验证” icon:check-circle color:#10b981
== tab “Markdown 源码”

::: tag "已验证" icon:check-circle color:#10b981

:::

链接标签

如果你需要标签充当超链接(例如,将版本标签直接链接到其发布说明),可以使用 link: 属性。外部链接会被自动检测并在新标签页中打开。

预览
Markdown 源码

查看最新的 ::: tag “发行说明” icon:external-link link:/release-notes/0-7-4

查看最新的 ::: tag "发行说明" icon:external-link link:/release-notes/0-7-4

在标题中使用标签

因为标签是真正的行内元素,所以当用于标记主标题时,它们看起来非常华丽。它们会自动对齐到基线,而不会继承标题巨大的字体大小。

预览
Markdown 源码

搜索过滤 ::: tag “新” color:#8b5cf6

# 搜索过滤 ::: tag "新" color:#8b5cf6