卡片 (Cards)
卡片将相关内容封装到一个独特的、带边框的框架中,可选带标题,为文档提供清晰的视觉层次结构。
语法参考
::: card "标题文本" [属性:值...]
这是卡片的主要内容区域。
:::
| 参数 | 类型 | 说明 |
|---|---|---|
| 标题 | "字符串" |
可选的页眉标题,渲染在卡片顶部。 |
| 图标 | icon:名称 |
可选。在标题文本旁边添加一个 Lucide 图标。 |
示例
功能亮点
使用卡片来框定具有清晰标题和图标的单一技术功能。
::: card "异步生成" icon:zap
核心引擎使用非阻塞 I/O 管道,可在毫秒内生成数千个页面。
:::
异步生成
核心引擎使用非阻塞 I/O 管道,可在毫秒内生成数千个页面。
丰富内容
卡片接受任何标准 Markdown,包括代码块和按钮。
::: card "即时国际化"
使用内置的 i18n 支持为全球受众准备文档。
```bash
npx @docmd/core add i18n
```
::: button "国际化策略指南" /guides/localization
:::
即时国际化
多列布局
将多个卡片包裹在 grids 容器中,以获得响应式多列布局。
::: grids
::: grid
::: card "主节点"
主实例的配置。
:::
:::
::: grid
::: card "从节点"
冗余从实例的配置。
:::
:::
:::
主节点
主实例的配置。
从节点
冗余从实例的配置。
AI 的语义聚类
在 llms-full.txt 流中,卡片包裹的内容被 AI 代理视为内聚主题集群。使用卡片来分隔不相关的概念可防止上下文泄漏,并确保 LLM 生成的摘要在逻辑上保持隔离。