538 字
3 分钟
页面浏览--访问次数--
代码选项组

代码选项组(Tabs / Code Group)用于在同一卡片中并排切换展示多种编程语言、包管理器命令或不同环境的操作指南。

语法格式#

使用 ::: tabs 容器与 @tab 分割子选项卡:

::: tabs#markdown-tabs-demo
@tab pnpm#pnpm
```bash
pnpm install
pnpm dev
```
@tab npm#npm
```bash
npm install
npm run dev
```
@tab Bun#bun
```bash
bun install
bun dev
```
:::

渲染效果:

pnpm
Terminal window
pnpm install
pnpm dev
npm
Terminal window
npm install
npm run dev
Bun
Terminal window
bun install
bun dev

@tab 标签文字#同步标识 是完整写法:井号前是显示文案,井号后是全站同步用的标识。

标签内容不限于代码#

每个 @tab 内部都是完整的 Markdown 上下文,表格、列表、提示容器都可以放入:

::: tabs#deploy-target
@tab Vercel#vercel
在 Vercel 中导入内容仓库,构建命令填写 `pnpm build`。
| 配置项 | 值 |
| --- | --- |
| 输出目录 | `dist` |
| Node 版本 | 22 |
@tab Cloudflare Pages#cloudflare
在 Cloudflare Pages 中连接同一仓库。
| 配置项 | 值 |
| --- | --- |
| 构建命令 | `pnpm build` |
| 输出目录 | `dist` |
:::

渲染效果:

Vercel

在 Vercel 中导入内容仓库,构建命令填写 pnpm build。

配置项值
输出目录dist
Node 版本22
Cloudflare Pages

在 Cloudflare Pages 中连接同一仓库。

配置项值
构建命令pnpm build
输出目录dist

指定默认激活项#

使用 @tab:active 显式标记初次加载时选中的选项卡:

::: tabs#runtime-choice
@tab Node.js#node
Node.js 运行时。
@tab:active Bun#bun
Bun 运行时(默认选中)。
:::

渲染效果:

Node.js

Node.js 运行时。

Bun

Bun 运行时(默认选中)。

核心特性#

  • 默认激活:使用 @tab:active 显式标记初次加载默认选中的选项卡。
  • 全局同步:全站相同 #id 的选项卡(如 #pnpm)点击切换时会自动保持联动同步。
  • 键盘导航:完全支持左右方向键切换焦点。
需求推荐写法
切换命令或代码::: tabs + @tab
折叠而不切换代码折叠 collapse={4-8}
强调差异差异标记 ins / del

第 17 篇,共 30 篇本文属于系列

代码选项组
https://www.ariels.xyz/posts/markdown-tabs/
作者
Ariel
发布于
2026-10-03
许可协议
CC BY-NC-ND 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...