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
Asynchrone Generierung

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"
:::
Sofortige Lokalisierung

Bereiten Sie Ihre Dokumentation für ein globales Publikum mit integrierter i18n-Unterstützung vor.

npx @docmd/core build
Leitfaden zur Lokalisierungsstrategie

Mehrspaltiges 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
Primärer Knoten

Konfigurationsoptionen für Master-Instanzen.

Sekundärer Knoten

Konfigurationsoptionen für Replica-Instanzen.

Semantisches Clustering für KI

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.