卡片将相关内容封装到一个独特的、带边框的框架中,可选带标题,为文档提供清晰的视觉层次结构。

语法参考

::: card "标题文本" [属性:值...]
这是卡片的主要内容区域。
:::
参数 类型 说明
标题 "字符串" 可选的页眉标题,渲染在卡片顶部。
图标 icon:名称 可选。在标题文本旁边添加一个 Lucide 图标。

示例

功能亮点

使用卡片来框定具有清晰标题和图标的单一技术功能。

::: card "异步生成" icon:zap
核心引擎使用非阻塞 I/O 管道,可在毫秒内生成数千个页面。
:::
异步生成

核心引擎使用非阻塞 I/O 管道,可在毫秒内生成数千个页面。

丰富内容

卡片接受任何标准 Markdown,包括代码块和按钮。

::: card "即时国际化"
使用内置的 i18n 支持为全球受众准备文档。

```bash
npx @docmd/core add i18n
```

::: button "国际化策略指南" /guides/localization
:::
即时国际化

使用内置的 i18n 支持为全球受众准备文档。

npx @docmd/core add i18n
国际化策略指南

多列布局

将多个卡片包裹在 grids 容器中,以获得响应式多列布局。

::: grids
    ::: grid
        ::: card "主节点"
        主实例的配置。
        :::
    :::
    ::: grid
        ::: card "从节点"
        冗余从实例的配置。
        :::
    :::
:::
主节点

主实例的配置。

从节点

冗余从实例的配置。

AI 的语义聚类

llms-full.txt 流中,卡片包裹的内容被 AI 代理视为内聚主题集群。使用卡片来分隔不相关的概念可防止上下文泄漏,并确保 LLM 生成的摘要在逻辑上保持隔离。