Cards are the primary structural building blocks in docmd. They encapsulate related content into a distinct, bordered frame with optional headers, providing a clear visual hierarchy for your documentation.
Syntax Reference
::: card "Optional Header Title"
This is the primary content area of the card.
:::
Add an optional icon: parameter to display a Lucide icon in the header:
::: card "Setup" icon:rocket
Get started in seconds.
:::
Get started in seconds.
Practical Implementation Examples
1. Feature Showcasing
Use cards to highlight key technical advantages or module capabilities.
::: card "Asynchronous Generation"
The `docmd` core engine utilises a non-blocking I/O pipeline, enabling the generation of thousands of pages in milliseconds.
:::
The docmd core engine utilises a non-blocking I/O pipeline, enabling the generation of thousands of pages in milliseconds.
2. Multi-Component Integration
Cards can house any standard Markdown elements, including syntax-highlighted code and call-to-action buttons.
::: card "Instant Localisation"
Prepare your documentation for a global audience using the built-in i18n support.
```bash
docmd add i18n
```
::: button "L10n Strategy Guide" /guides/localization
:::
Prepare your documentation for a global audience using the built-in i18n support.
docmd add i18n
Multi-Column Layouts (Grids)
You can leverage the native grids container to organise your cards into clean, responsive multi-column layouts without ever touching HTML.
::: grids
::: grid
::: card "Primary Node"
Configuration for the master instance.
:::
:::
::: grid
::: card "Secondary Node"
Configuration for redundant slave instances.
:::
:::
:::
In the llms-full.txt stream, content wrapped in a card is treated by AI agents as a Cohesive Topic Cluster. Utilizing cards to segment unrelated technical concepts on the same page prevents context leakage and ensures that LLM-generated summaries remain logically isolated and accurate.