Container-Übersicht
docmd-Container ermöglichen es Ihnen, komplexe UI-Elemente wie Buttons, Cards, ausklappbare Abschnitte und Tabs direkt in Ihre Dokumentationsquellen einzufügen, ohne HTML oder CSS schreiben zu müssen.
Block-Syntax-Referenz
Alle Container nutzen eine konsistente Block-Syntax, die eine vorhersehbare Bearbeitungserfahrung im gesamten Projekt gewährleistet.
::: typ "Optionaler Titel für die Kopfzeile"
Dies ist der primäre Inhaltsbereich.
Er unterstützt **Markdown**, Bilder und tiefe Verschachtelung von Komponenten.
:::
| Komponente | Schlüsselwort | Primärer Anwendungsfall |
|---|---|---|
| Callouts | callout |
Semantische Hervorhebungen für Tipps, Warnungen und Alarme. |
| Cards | card |
Gerahmte strukturelle Blöcke für Feature-Grids und Layout-Steuerung. |
| Grids | grids |
Sich automatisch anpassende, mehrspaltige Strukturgruppen. |
| Tabs | tabs |
Interaktive, umschaltbare Fenster für alternative Anweisungen (z.B. Betriebssysteme). |
| Steps | steps |
Visuelle, nummerierte Zeitachsen für “How-to”-Anleitungen und Tutorials. |
| Tags | tag |
Selbstschließende, farbige Labels für Versionen, Status oder Hervorhebungen. |
| Buttons | button |
Selbstschließende, prominente Call-to-Action-Navigationslinks. |
| Collapsibles | collapsible |
Interaktive Akkordeon-Umschalter für FAQs und vertiefende technische Daten. |
| Changelogs | changelog |
Strukturierte, zeitachsenbasierte Versionshistorie und Versionshinweise. |
| Hero | hero |
Wirkungsvolle Landingpage-Abschnitte mit Layout- und Slider-Unterstützung. |
Die strategische Bedeutung von Containern
Container bieten mehr als nur optischen Glanz; sie liefern hochpräzise semantische Signale an die docmd-Engine und nachgeschaltete KI-Agenten:
- KI-Kontext-Mapping: Das Markieren eines Blocks als
callout warningsignalisiert LLMs explizit, diese Informationen während der Denk- und Generierungsphasen zu priorisieren. - Strukturelle Integrität: Die Kombination von
cardsmit Standard-CSS ermöglicht die Erstellung anspruchsvoller Landingpages, ohne die Markdown-Umgebung zu verlassen. - Wartbarkeit des Quellcodes: Eliminiert “HTML-Aufblähung” in Ihrem Dokumentationsquellcode und hält Ihre
.md-Dateien sauber und maschinenlesbar.
Rekursive Komposition
docmd unterstützt unendliche Verschachtelungstiefe. Sie können jeden Container in einem anderen kombinieren, um komplexe, interaktive Dokumentationsknoten rein in Markdown zu erstellen.
::: card "Architektur-Übersicht"
::: callout info
Dieses Modul nutzt eine asynchrone I/O-Pipeline.
:::
::: button "Tiefes Eintauchen in den Core" /advanced/developer-guide
:::