Karten (Cards)
Karten kapseln zusammengehörige Inhalte in einem eigenen, umrandeten Rahmen mit einem optionalen Header ein und bieten eine klare visuelle Hierarchie auf Ihren Dokumentationsseiten.
Container-Syntax
::: card [title:"Header-Titel"] [icon:Icon-Name] # Karten-Container Öffner
Inhaltsblock mit Unterstützung für Markdown, Code-Snippets, Buttons und Callouts...
::: /card # Explizites Schließ-Tag
Funktionen & Unterstützte Attribute
| Parameter / Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Titel | "String" | title:"..." |
Optionaler Header-Titel oben im Kartenrahmen (1. positionaler Parameter oder title:"..."). |
| Symbolik | icon:NAME |
Optional. Fügt ein Lucide-Symbol neben dem Titeltext ein. |
| Markdown-Inhalt | Freitext | Unterstützt beliebige Markdown-Elemente, Codeblöcke, Listen, Buttons und verschachtelte Container. |
Anwendungsbeispiele
Feature-Highlight-Karte
Verwenden Sie eine Karte, um eine einzelne technische Funktion mit einem expliziten Titel und Icon einzurahmen:
::: card title:"Asynchrone Generierung" icon:zap
Die Core-Engine nutzt eine nicht-blockierende I/O-Pipeline und kompiliert Tausende von Seiten in Millisekunden.
::: /card
Die Core-Engine nutzt eine nicht-blockierende I/O-Pipeline und kompiliert Tausende von Seiten in Millisekunden.
Komposition reichhaltiger Inhalte
Karten akzeptieren jegliche Markdown-Inhalte, einschließlich Code-Snippets und Button-Container:
::: card title:"Sofortige Lokalisierung"
Bereiten Sie Ihre Dokumentation für ein globales Publikum mit integrierter i18n-Unterstützung vor.
```bash
npx @docmd/core build
```
::: button title:"Leitfaden zur Lokalisierungsstrategie" url:"../getting-started/quick-start.md"
:::
Bereiten Sie Ihre Dokumentation für ein globales Publikum mit integrierter i18n-Unterstützung vor.
npx @docmd/core build
Leitfaden zur LokalisierungsstrategieMehrspaltiges Layout
Umschließen Sie mehrere Karten mit einem grids-Container für ein responsives mehrspaltiges Layout:
::: grids
::: grid
::: card title:"Primärer Knoten"
Konfigurationsoptionen für Master-Instanzen.
::: /card
::: /grid
::: grid
::: card title:"Sekundärer Knoten"
Konfigurationsoptionen für Replica-Instanzen.
::: /card
::: /grid
::: /grids
Konfigurationsoptionen für Master-Instanzen.
Konfigurationsoptionen für Replica-Instanzen.
Im llms.txt-Kontextstream werden Inhalte innerhalb einer card als kohärenter Themen-Cluster geparst. Die Verwendung von Karten zur Segmentierung von Konzepten verhindert Kontextlecks über unzusammenhängende Abschnitte hinweg.