diff --git a/docs/v2/features/action-sharing.md b/docs/v2/features/action-sharing.md
index fc2f966..4b216fa 100644
--- a/docs/v2/features/action-sharing.md
+++ b/docs/v2/features/action-sharing.md
@@ -12,7 +12,7 @@ Quicker 2.2.1 起，动作和公共子程序使用统一的分享与版本体系
 
 这意味着作者不必维护两条互不关联的分享记录，使用者也可以从同一个网页查看版本历史、安装适合当前 Quicker 的内容。
 
-:::note 版本要求
+:::note[版本要求]
 请使用 Quicker 2.2.1 或更高版本发布、更新和安装新版 Quicker 2.0 原生分享。若要安装只有 V2 制品的动作，或在动作设计器中下载网络共享子程序，建议升级到 Quicker 2.2.3 或更高版本，避开 2.2.1–2.2.2 中已修复的格式读取和下载问题。较早的 V2 客户端使用过一套独立分享方式，只保留有限的读取兼容能力。
 :::
 
@@ -40,7 +40,7 @@ V1 和 V2 只是同一修订中的两种可安装内容，不是两条独立分
 
 公开分享需要填写动作说明，并为动作设置合适的图标，不能使用默认图标。标签、分类和更详细的图文介绍可以在分享后的网页中继续编辑。
 
-:::warning 分享前检查内容
+:::warning[分享前检查内容]
 无论公开还是不公开，都不要在动作或子程序中保存密码、Token、账号凭据、私人文件内容等敏感信息。不公开分享不会出现在动作库中，但持有网址的已登录用户仍可安装。
 :::
 
diff --git a/docs/v2/features/floating-actions.md b/docs/v2/features/floating-actions.md
index ea7cc36..b3e107c 100644
--- a/docs/v2/features/floating-actions.md
+++ b/docs/v2/features/floating-actions.md
@@ -10,7 +10,7 @@ comments: true
 
 悬浮动作让常用动作留在桌面上，不必每次打开动作面板。把多个悬浮动作组成一组后，可以一起移动、统一调整大小，也可以让它们只在指定程序中显示，或跟随程序窗口移动。
 
-:::note 版本说明
+:::note[版本说明]
 2.2.6 起提供悬浮分组。若当前版本中没有“管理悬浮分组”或“悬浮此分组”等入口，请先确认版本。分组模式默认关闭；启用或关闭后需要重启 Quicker 才生效。开关随账号同步，布局、名称和窗口跟随仅保存在本机。
 :::
 
@@ -148,7 +148,7 @@ comments: true
 
 这些操作都不会删除动作本体，也不会删除面板上的动作。
 
-:::warning 手柄中键：命名分组关闭，未命名可能删除
+:::warning[手柄中键：命名分组关闭，未命名可能删除]
 2.2.13 起，对**命名分组**，中键单击手柄为关闭分组（可再次显示），不是删除布局。未命名或临时分组仍可能按删除处理。重要布局建议先备份。
 :::
 
diff --git a/docs/v2/features/triggers/left-button-plus.md b/docs/v2/features/triggers/left-button-plus.md
index 69de771..f102c34 100644
--- a/docs/v2/features/triggers/left-button-plus.md
+++ b/docs/v2/features/triggers/left-button-plus.md
@@ -46,7 +46,7 @@ comments: true
 
 功能设置可分别保存白名单和黑名单。白名单非空时只允许其中的程序；白名单为空时使用黑名单；两者都为空时适用所有程序。名单支持搜索、选择运行中程序、选窗口和批量粘贴，不需要先创建程序场景。
 
-:::warning 多设备与回退
+:::warning[多设备与回退]
 旧客户端不支持新增的多键、短长按模式和白名单，保存并同步设置可能丢失这些字段。请先备份，并升级所有维护这些规则的设备；回退后避免修改、同步相关设置。丢失后需要从备份恢复或重新配置。详见 [体验前必读](/important-notice#2211-触发设置的多设备与回退风险)。
 :::
 
diff --git a/docs/v2/xaction/guides/web-data-and-form-automation.md b/docs/v2/xaction/guides/web-data-and-form-automation.md
index c031c7e..05a7570 100644
--- a/docs/v2/xaction/guides/web-data-and-form-automation.md
+++ b/docs/v2/xaction/guides/web-data-and-form-automation.md
@@ -19,7 +19,7 @@ Quicker Connector 1.2.0 增加了可视化的网页工具。你可以在浏览
 
 模板不保存本次填写值，因此同一份模板可以反复使用，也更适合分享动作。
 
-:::tip 使用条件
+:::tip[使用条件]
 请安装 Quicker Connector 1.2.0 或更高版本，并使用包含“提取网页列表数据”和“填写网页表单”操作的 Quicker V2 版本。官网 2.1.27 记录发布时，Edge 商店已发布 1.2.0，Chrome 商店待审核；旧版扩展不能执行这些新操作。
 :::
 
diff --git a/docs/v2/xaction/guides/web-page-control.md b/docs/v2/xaction/guides/web-page-control.md
index db033cc..f14fa54 100644
--- a/docs/v2/xaction/guides/web-page-control.md
+++ b/docs/v2/xaction/guides/web-page-control.md
@@ -12,7 +12,7 @@ legacyContentUpdatedAt: "2023-03-11T12:42:09.000Z"
 
 本页保留逐个读取、修改或触发网页元素的传统示例，适合维护旧动作或处理少量单元素操作。
 
-:::tip 新动作优先使用专用操作
+:::tip[新动作优先使用专用操作]
 批量提取列表、连续翻页或填写多个表单字段时，建议使用新版“提取网页列表数据”和“填写网页表单”。扩展可以可视化生成模板，通常不需要手写选择器。参见[网页列表提取与表单填写](/v2/xaction/guides/web-data-and-form-automation)。单元素点击、填写或选择则优先使用“操作网页元素（推荐）”。
 :::
 
diff --git a/docs/v2/xaction/modules/basic/notify.md b/docs/v2/xaction/modules/basic/notify.md
index e3668b1..9f60ea1 100644
--- a/docs/v2/xaction/modules/basic/notify.md
+++ b/docs/v2/xaction/modules/basic/notify.md
@@ -126,7 +126,7 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z"
 [{"Title":"再次运行","Operation":"action","Action":"_this_"}]
 ```
 
-:::note Windows 通知
+:::note[Windows 通知]
 
 “Windows 通知 (win10+)”支持普通文本形式的整卡点击命令，但不支持 `@button` / `@buttons` 按钮模式；使用按钮格式时，Quicker 会忽略点击操作并显示普通通知。
 
diff --git a/docs/v2/xaction/modules/input/automationscript.md b/docs/v2/xaction/modules/input/automationscript.md
index 38dd887..86b6164 100644
--- a/docs/v2/xaction/modules/input/automationscript.md
+++ b/docs/v2/xaction/modules/input/automationscript.md
@@ -15,7 +15,7 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 
 使用 JavaScript 编排鼠标、键盘、Quicker 提示消息、文本剪贴板以及屏幕识别相关操作。适合坐标数组、循环、网格、批量点击、键鼠组合以及根据运行结果显示消息或读写文本这类用普通步骤不方便表达的自动化。
 
-:::warning 安全提示
+:::warning[安全提示]
 
 导入 `mouse` 或 `key` 时，本模块会操作真实鼠标和键盘。首次运行相关能力时需要确认桌面控制权限；脚本运行期间，用户操作键盘或鼠标会接管并取消脚本。导入 `clipboard` 时也需要确认本机剪贴板权限。请先用少量输入测试，不要一开始就对重要数据执行大量点击、按键、剪贴板写入或文本输入。
 
@@ -148,7 +148,7 @@ mouse.click([100, 200]);
 mouse.click({ x: 100, y: 200 });
 ```
 
-:::caution `(x, y)` 不是 JavaScript 的坐标类型
+:::caution[(x, y) 不是 JavaScript 的坐标类型]
 
 ```javascript
 const p = (100, 200); // p 的值只有 200
diff --git a/docs/v2/xaction/modules/ui/reactui.md b/docs/v2/xaction/modules/ui/reactui.md
index 2930476..02a7d7b 100644
--- a/docs/v2/xaction/modules/ui/reactui.md
+++ b/docs/v2/xaction/modules/ui/reactui.md
@@ -15,7 +15,7 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 
 用单文件 TSX 编写可交互窗口：用户点确定后，界面把数据通过 **返回结果** 交给后续步骤；取消或关窗则视为用户取消。适合需要自定义布局、动态校验或比固定表单更灵活的输入场景。
 
-:::info 与其它界面步骤怎么选
+:::info[与其它界面步骤怎么选]
 
 - 固定字段、拖拽设计表单：用 [多字段表单](/v2/xaction/modules/form)。
 - 需要 WPF / XAML、复杂桌面绑定：用 [自定义窗口](/v2/xaction/modules/customwindow)。