Highlights

docmd v0.9.1 bringt eine umfassende Modernisierung der Container-Engine mit sich: Einführung standardisierter, expliziter Schließungs-Tags, expliziter Key-Value-Header-Attribute, nachfolgender # Kommentare, eines nativen ::: mermaid Diagramm-Containers, der Behebung von Issue #187 (Leerzeilen in HTML-Blöcken im noStyle-Modus) sowie vollständige 1:1-Dokumentationsparität in allen unterstützten Sprachen (en, de, es, zh).

Standardisierung der Container-Engine

• Explizite Schließungs-Tags: Standardisierte explizite Schließungs-Tags (::: container … ::: /container) über alle strukturellen Container hinweg für deterministische Blockauflösung und unbegrenzte Verschachtelungstiefe.
• Einheitliche Sub-Container-Nomenklatur: Einführung benannter Sub-Container-Elemente (::: tab … ::: /tab für ::: tabs, ::: step … ::: /step für ::: steps, ::: log … ::: /log für ::: changelog). Ältere Marker (== tab, 1.) werden zur Abwärtskompatibilität weiterhin unterstützt.
• Explizite Key-Value-Formatierung: Standardisierte benannte Parametersyntax (title:"...", url:"...", align:center, zoom:true, icon:name) in Container-Headern bei Beibehaltung von Fallbacks für positionale Argumente.
• Container-Header-Kommentare: Native Unterstützung für nachfolgende # Kommentare auf Container-Zeilen (::: tabs # Header-Kommentar, ::: /tabs # Schließungs-Kommentar).
• Normalisierer für selbstschließende Container & Flexible Schließ-Tags: Erweitertes Depth Tracking, Inline-Einbettung in Absätzen (::: button, ::: tag) und automatisches Entfernen verwaister Tags bei selbstschließenden Containern (::: button, ::: tag, ::: embed). Optionale explizite Schließ-Tags (::: /button, ::: /tag) werden vollständig unterstützt.
• Neuer Tooltip-Container (::: tip): Einführung interaktiver Hover-Tooltips (::: tip "Erklärung" term:"Begriff" ::: /tip) für Inline- und Block-Dokumentations-Popups.

Nativer ::: mermaid Diagramm-Container

• Erweiterte Container-UI: Einführung eines dedizierten ::: mermaid Containers, der Diagramm-DSL in eine interaktive Hülle einbettet – inklusive benutzerdefinierter Header, Titelzeilen, Icons, Ausrichtung (left, center, right), integrierter Theme-Overrides (default, dark, forest, neutral) sowie Zoom- und Pan-Steuerelementen.
• Plugin-gebundene Ausführung: Direkt betrieben von @docmd/plugin-mermaid. Wenn das Plugin in der docmd.config.json deaktiviert ist, werden sowohl ::: mermaid Container als auch Codeblöcke sauber deaktiviert, ohne clientseitige JS-Assets zu laden.
• Hybride GFM-Kompatibilität: Standard-Markdown-Codeblöcke (```mermaid) bleiben zu 100 % für die universelle Kompatibilität mit GitHub und IDE-Vorschauen unterstützt.

KI-Assistent-Erweiterungen & Navigations-Werkzeuge

• Neues get_site_structure-Werkzeug: @docmd/plugin-ai wurde mit einem Strukturanalyse-Werkzeug (get_site_structure) ausgestattet, mit dem der KI-Assistent das vollständige Versionsmanifest der Website (aktuell & historisch), unterstützte Sprachen, das Multi-Projekt-Workspace-Setup und den kompletten Seitennavigationsbaum mit Titeln und URLs abrufen kann.
• Dynamische Erkennung von Suchfunktionen: Der KI-Assistent wertet nun die Build-Metadaten von @docmd/plugin-search (searchCapabilities: { keyword: true, semantic: Boolean }) aus, um dynamisch zu erkennen, ob die semantische Vektorsuche aktiviert ist oder die reine Stichwortsuche (MiniSearch) läuft.
• Optimierung von Stichwort- & Semantik-Suchanfragen: Das Prompt-Routing und die Anweisungen des Assistenten wurden so aktualisiert, dass Anfragen an search_documentation Suchbegriffe automatisch in präzise Stichwörter (z. B. "containers hero") umformulieren, um ungenaue Ergebnisse bei Stichwort-Suchmaschinen zu vermeiden und die Relevanz bei semantischen Indizes zu maximieren.

Engine und Bug-Fixes

• Leerzeilen in HTML-Blöcken (Issue #187): Behebung eines Fehlers, bei dem Leerzeilen zwischen HTML-Elementen in noStyle-Seiten oder Standard-Markdown-Dateien dazu führten, dass nachfolgende HTML-Elemente als unformatierter Klartext gerendert wurden.
• Erhaltung von Zero-Config SPA-Homepage-Links (Issue #196): Behebung eines Problems bei der Synchronisation der Sidebar-Navigation in SPAs, bei dem Links zur Root-Startseite (<a href="">) versehentlich in <a href="#"> umgewandelt wurden, wodurch eine Rückkehr zur Dokumentations-Startseite blockiert wurde.
• Banner-Rendering im Summer-Template: Behebung eines Problems in @docmd/template-summer, bei dem objektbasierte Ankündigungs-Banner-Konfigurationen (mit Markdown-Formatierung, Typvarianten, Links, Icons und Schließen-Schaltflächen) Bannertext und -komponenten nicht gerendert haben.

Globale Dokumentationsparität

• Mehrsprachige Synchronisation: Aktualisierung aller Dokumentationsseiten, Container-Anleitungen und Code-Beispiele 1:1 auf Englisch (en), Deutsch (de), Spanisch (es) und Chinesisch (zh).