一、GitHub 仓库卡片（GitHub Repository Cards）

支持添加动态 GitHub 仓库卡片，页面加载时会通过 GitHub API 拉取仓库实时信息（如星标数、分支数等）。

使用示例

::github

语法格式

::github{repo="用户名/仓库名"}

• repo 参数：必填，格式为「GitHub 用户名/仓库名称」（如 matsuzaka-yuki/Mizuki）

二、提示框（Admonitions）

支持 5 种预设类型的提示框，用于突出显示不同重要程度的信息，适配多种使用场景。

支持类型及示例

类型	语法标识	效果示例
说明	note	::
技巧	tip	::
重要	important	::
警告	warning	::
注意（谨慎）	caution	::

基础语法

:::类型标识
提示框内容（支持换行）
:::

自定义标题

可修改提示框默认标题，语法如下：

:::note[我的自定义标题]
这是一个带有自定义标题的说明提示框。
:::

效果： ::

GitHub 兼容语法

同时支持 GitHub 官方提示框语法（无缝适配 GitHub 文档风格）：

> [!NOTE]
> GitHub 语法的说明提示框。
> 支持多行内容。

> [!TIP]
> GitHub 语法的技巧提示框。

效果：

注

GitHub 语法的说明提示框。 支持多行内容。

提示

GitHub 语法的技巧提示框。

三、折叠剧透（Spoiler）

支持添加折叠式剧透内容，默认隐藏，hover 或点击时显示，内容支持 Markdown 格式。

使用示例

这是普通文本，剧透内容：:spoiler[被隐藏的**剧透内容**（支持粗体等 Markdown 语法）]！

效果： 这是普通文本，剧透内容：:spoiler[被隐藏的剧透内容（支持粗体等 Markdown 语法）]！

语法格式

:spoiler[剧透内容（可包含 Markdown 语法）]

版权所有

版权归属：Matsuzaka-Yuki

许可证：署名 4.0 国际 (CC-BY-4.0)