Eine der leistungsfähigsten technischen Fähigkeiten von docmd ist seine rekursive Parsing-Engine. Sie können Komponenten unendlich ineinander verschachteln, um komplexe, interaktive Dokumentationsblöcke zu erzeugen, die andernfalls tiefgreifende HTML-Kenntnisse oder benutzerdefinierte Vorlagen erfordern würden.

Die architektonische Regel

Obwohl die Verschachtelung mathematisch gesehen unendlich ist, sollten Sie sich immer an die Regel für selbstschließende Komponenten halten:

Beispiele für technische Komposition

1. Interaktiver Ressourcenblock

Kombinieren Sie eine Karte (Card) für den strukturellen Rahmen, Tabs für umgebungsspezifische Anweisungen und Callouts zur Hervorhebung kritischer Informationen.

::: card "Monorepo Schnellstart"
Wählen Sie Ihren bevorzugten Initialisierungspfad:

   ::: tabs
   == tab "Automatisiert"
      ```bash
      pnpm onboard
      ```
      ::: callout success
      Dieses Skript übernimmt alle Paketinstallationen und Build-Aufgaben automatisch.
      :::

   == tab "Manuell"
      Holen und verknüpfen Sie die Core-Engine manuell.
      ::: button "Zum Entwickler-Leitfaden" /advanced/developer-guide
   :::
:::

2. Multi-Plattform-Tutorials

Das Verschachteln von Tabs innerhalb von Schritten (Steps) ist ein professionelles Muster, um plattformspezifische Anweisungen innerhalb einer Standard-Tutorial-Sequenz bereitzustellen.

::: steps

1. **Umgebung einrichten**
   Konfigurieren Sie Ihr lokales Betriebssystem.

   ::: tabs
   == tab "macOS"
      Stellen Sie sicher, dass Homebrew installiert und aktuell ist.
   == tab "Linux"
      Überprüfen Sie das Vorhandensein von `curl` und `bash`.
   :::

2. **Kern-Verifizierung**
   Führen Sie den Versionscheck aus, um die Konnektivität zu bestätigen.

:::

Design-Einschränkungen

Um sowohl die Performance als auch die mobile Responsivität zu wahren, beachten Sie die folgenden Einschränkungen:

• Rekursive Tabs: Das Verschachteln von Tabs innerhalb anderer Tabs wird technisch unterstützt, ist jedoch ausdrücklich nicht empfohlen. Es erzeugt Navigations-“Schleifen”, die auf kleineren Viewports optisch verwirrend sind.
• Sequenzieller Konflikt: Wenn Sie nummerierte Schritte innerhalb eines Tabs benötigen, verwenden Sie eine standardmäßige geordnete Liste (1. Schritt-Inhalt) anstelle des ::: steps-Containers, um Layout-Konflikte zu vermeiden.
• Lesbarkeit: Obwohl docmd keine Einrückung für verschachtelte Blöcke zwingend vorschreibt, verbessert eine Einrückung von 2 oder 4 Leerzeichen die menschliche Lesbarkeit des Markdown-Quellcodes erheblich.