Das docmd 0.7.3 Release bringt bedeutende neue Authoring-Funktionen, eine produktionsreife Migrations-Engine für Benutzer, die von konkurrierenden Plattformen wechseln, und eine komplette Überarbeitung der Mermaid-Diagramm-Rendering-Pipeline. Wir haben außerdem die Icon-Rendering-Logik in allen interaktiven Containern vereinheitlicht und eine tief kontextbezogene Paginierungslogik eingeführt.

✨ Highlights

🚀 Multi-Service-Migrations-Engine

Wir haben das veraltete interne Konfigurationsmigrationstool durch eine voll funktionsfähige Migrations-Engine ersetzt, die Ihr gesamtes Dokumentationsprojekt mit einem einzigen Befehl von einer konkurrierenden Plattform zu docmd verschieben kann.

Unterstützte Quellen

Jede Migration führt automatisch Folgendes aus:

1. Erkennt die Konfigurationsdatei des Quellprojekts und extrahiert den Website-Titel.
2. Verschiebt alle vorhandenen Dateien sicher in ein <source>-backup/-Verzeichnis.
3. Kopiert die Dokumentations-Quelldateien (z. B. docs/, src/content/docs/ usw.) in die Standard-docs/-Struktur von docmd.
4. Erzeugt eine sofort einsatzbereite docmd.config.js mit sinnvollen Standardwerten.

cd my-docusaurus-site
npx @docmd/core migrate --docusaurus
npx @docmd/core dev

Hinweis: Da jede Dokumentationsplattform komplexe Logik wie Sidebars, Versionierung und Lokalisierung (i18n) über proprietären Code oder APIs abwickelt, versucht docmd nicht, diese Konfigurationen automatisch zu übersetzen, um zu vermeiden, dass Ihr Build zerstört wird. Die Migrations-Engine konzentriert sich ausschließlich darauf, Ihre Markdown-Inhalte und Assets sicher zu verschieben, während die Einrichtung von navigation.json und localisation Ihnen über die einfachen nativen APIs von docmd überlassen bleibt.

Lesen Sie unsere neuen umfassenden Migrationsleitfäden, um genau zu sehen, was migriert wird und welche einfachen Schritte erforderlich sind, um die Konfiguration Ihres vorherigen Tools auf docmd abzubilden.

📝 Code-Block-Titel

Sie können nun jedem umzäunten Code-Block einen beschreibenden Dateinamen oder Titel hinzufügen, indem Sie eine in Anführungszeichen gesetzte Zeichenfolge nach dem Sprachbezeichner platzieren. Dies rendert eine saubere, Mintlify-ähnliche Kopfzeile über dem Code.

```javascript "config.js"
export default {
  title: "My Site"
};
```

Der Titel wird als semantische Beschriftung (nicht als Überschrift) gerendert, sodass er niemals im Inhaltsverzeichnis erscheint oder Ihre Seitenstruktur stört.

📊 Interaktive Mermaid-Diagramme

Wir haben die Art und Weise, wie docmd Mermaid-Diagramme rendert, komplett überarbeitet und statische SVGs in tief interaktive visuelle Elemente verwandelt.

• Intelligente Skalierung: Diagramme werden in voller Mermaid-Qualität gerendert und dann intelligent skaliert, um sich mit CSS-Transformationen an die Inhaltsbreite anzupassen, wobei alle Beschriftungen und Kantenpositionierungen erhalten bleiben.
• Schwenken & Ziehen: Klicken und ziehen Sie, um in großen Diagrammen zu schwenken. Es gibt jetzt auch native Pfeiltasten im UI für einfachere mobile Bedienung.
• Zoom-Steuerelemente: Spezielle Vergrößern/Verkleinern-Schaltflächen werden beim Überfahren mit der Maus für eine präzise Überprüfung angezeigt.
• Vollbildmodus: Eine native Vollbild-Umschaltung ermöglicht es Benutzern, komplexe Diagramme für eine ablenkungsfreie Anzeige zu erweitern.
• Lucide Icon Integration: Das Lucide Icon-Paket wird direkt in die Mermaid-Engine registriert (icon:icon-name), was reichhaltige Architekturdiagramme mit denselben Icons ermöglicht, die auch in Ihrer Sidebar und Ihren Tabs verwendet werden.
• Dunkelmodus: Diagramme und ihre Container werden jetzt im Dunkelmodus mit richtig thematisierten Rahmen und Hintergründen korrekt gerendert.

✨ Isomorphe Container-Icons

Wir haben den Kernparser überarbeitet, um eine gemeinsame Container Integrity Engine zu verwenden. Dadurch wird sichergestellt, dass alle interaktiven Elemente - Callouts, Cards, Collapsibles und jetzt Tabs - eine einheitliche icon:name-Syntax unterstützen.

Icons in Tabs

Sie können nun jedes beliebige Lucide-Icon direkt zu Ihren Tab-Beschriftungen hinzufügen, um Ihren Benutzern einen sofortigen visuellen Kontext zu bieten.

::: tabs
== tab "npm" icon:box
npx @docmd/core dev

== tab "Bun" icon:zap
bunx docmd dev
:::

⚡ Erstklassige Bun-Unterstützung

Nach der schnellen Verbreitung der Bun-Laufzeitumgebung haben wir die gesamte Kerndokumentation und die “Erste Schritte”-Leitfäden aktualisiert, um native Bun-Beispiele (bunx, bun add) einzuschließen. Englische, chinesische und deutsche Leitfäden wurden synchronisiert.

🧭 Kontextbezogene Paginierungsnavigation

Die “Vorherige” und “Nächste” Seite Paginierungslinks am Ende der Artikel haben ein großes Intelligenz-Upgrade erhalten. Die Core Engine versteht nun nativ den outputPrefix-Kontext und stellt sicher, dass Ihre Leser beim sequenziellen Navigieren durch Ihre Dokumentation perfekt in ihrem aktuellen Sprach- und Versionssilo bleiben.

🎨 Visuelle Verfeinerungen

• Alle Code-Blöcke weisen nun weichere border-radius-Ecken und dezente Box-Schatten auf.
• Im Dunkelmodus wurde eine dedizierte --border-color-codeblock-Variable hinzugefügt, wodurch unsichtbare Ränder bei Code-Blöcken und Diagramm-Containern behoben werden.
• Mermaid-Diagramme sind jetzt in einem umrandeten, gepolsterten Container verpackt.

Migration Guide

Für Endbenutzer: Keine Änderungen erforderlich. Ein einfaches npm update @docmd/core genügt.

Für Plugin-Autoren: Wenn Sie bisher Tab-Header manuell analysiert haben, empfehlen wir den Wechsel zum exportierten Dienstprogramm parseTitleAndIcon aus @docmd/parser, um die Kompatibilität mit zukünftigen Icon-Verbesserungen aufrechtzuerhalten.

Für Benutzer anderer Dokumentationsplattformen: Führen Sie npx @docmd/core migrate --help aus, um alle verfügbaren Migrationsquellen anzuzeigen und in Sekunden loszulegen.