522 字
3 分钟
Markdown 选项组(Tabs)

选项组把等价的操作说明聚在一起,无需重复外围的解释文字。每个选项接受完整块级 Markdown,选中值还能与同页另一组同步。

  • @tab 标题 划分一个标签页
  • @tab:active 标记默认激活项
  • @tab 标题#值 用 # 后缀提供稳定的值(不改变可见标题)
  • ::: tabs#同步id 让多组共享选择状态

基础用法(含默认激活)#

写法

::: tabs#package-manager
@tab npm
用 npm 安装:
```powershell
npm install astro
```
@tab:active **pnpm**#pnpm
用 pnpm 安装:
```powershell
pnpm.cmd add astro
```
@tab Bun#bun
用 Bun 安装:
```powershell
bun add astro
```
:::

渲染效果

npm

用 npm 安装:

Terminal window
npm install astro
pnpm

用 pnpm 安装:

Terminal window
pnpm.cmd add astro
Bun

用 Bun 安装:

Terminal window
bun add astro

跨组同步#

这组与上面共享 package-manager id。在上面选择某一项,会联动更新下方匹配的命令,并为下次访问记住该选择。

写法

::: tabs#package-manager
@tab npm
```powershell
npm run dev
```
@tab pnpm
```powershell
pnpm.cmd dev
```
@tab Bun#bun
```powershell
bun run dev
```
:::

渲染效果

npm
Terminal window
npm run dev
pnpm
Terminal window
pnpm.cmd dev
Bun
Terminal window
bun run dev

较多备选#

较长的选项行保持单行,窄屏下在自己的导航区内横向滚动。

写法

::: tabs
@tab 本地工作站
开发功能时使用本地工具链。
@tab 托管预览环境
发布一个临时预览用于评审。
@tab 持续集成
对每次变更运行确定性校验。
@tab 生产部署
把验证过的产物发布到生产。
@tab 离线恢复流程
网络不可用时从本地产物恢复。
:::

渲染效果

本地工作站

开发功能时使用本地工具链。

托管预览环境

发布一个临时预览用于评审。

持续集成

对每次变更运行确定性校验。

生产部署

把验证过的产物发布到生产。

离线恢复流程

网络不可用时从本地产物恢复。

规则#

每个组至少需要两个 @tab 分节,且每个分节的正文需与标记之间空一行。非法或不完整的组保留为普通可读 Markdown。

第 6 篇,共 20 篇本文属于系列

分享文章

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

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取