网格在 docmd 中提供了一个原生的、由 markdown 驱动的布局系统。你可以利用 grids 容器来并排构建元素,而无需编写手动的 HTML 包装器。

列会自动调整宽度以填满可用空间,并在较小屏幕(移动设备)上逻辑地堆叠成垂直行。

语法参考

::: grids
    ::: grid
        #### 组件 A
        左侧的内容。
    :::
    ::: grid
        #### 组件 B
        右侧的内容。
    :::
:::

实际应用示例

1. 并排展示功能

使用网格将关键功能并排展示,例如将结构化卡片与信息块结合。

::: grids
    ::: grid
        ::: card "速度 :rocket:"
            建立在非阻塞 I/O 流水线上,以获得最高性能。
        :::
    :::
    ::: grid
        ::: card "可扩展性 :zap:"
            专为大规模 monorepos 和广泛的项目结构而设计。
        :::
    :::
:::
速度 🚀

建立在非阻塞 I/O 流水线上,以获得最高性能。

可扩展性 ⚡

专为大规模 monorepos 和广泛的项目结构而设计。

2. 布局平衡

网格将根据可用内容自动计算每列的最佳宽度(超宽屏幕上每行最多 4 个项目),并在窄视口上无缝分组行。

语义化布局

使用 grids 容器可以使你的文档结构纯粹用 Markdown 编写,从而产生更整洁的源文件,并确保 LLM 完美地解释你的结构关系!