DokuWiki erhält endlich integrierte Markdown-Unterstützung

Die nächste Version von DokuWiki wird voraussichtlich ein natives Markdown-Parsing bieten und den Nutzern damit eine Alternative zur bisherigen Wiki-Syntax bieten.
Eine Übersetzung von 🇬🇧 Linuxiac.com

DokuWiki, die seit langem etablierte Open-Source-Wiki-Software für Dokumentationen, Wissensdatenbanken und interne Projektnotizen, bereitet sich darauf vor, in ihrer nächsten Version native Markdown-Unterstützung hinzuzufügen. Damit erhalten Nutzer eine integrierte Alternative zur projektinternen Markup-Syntax für das Verfassen und Bearbeiten von Seiten.

🎓 Es handelt sich um eine schlanke Wiki-Plattform, und im Gegensatz zu datenbankgestützten Systemen speichert DokuWiki Seiten als reine Textdateien, was es bei Nutzern beliebt macht, die ein einfaches, selbst gehostetes Tool bevorzugen, das einfache Backups und Versionskontrolle unterstützt. Und es sieht so aus, als würde es bald noch besser werden.

Der DokuWiki-Entwickler Andreas Gohr kündigte an, dass die nächste Version das direkte Parsen und Rendern von Markdown unterstützen wird. Dies ist aus einem einfachen Grund von Bedeutung: DokuWiki hat traditionell seine eigene Syntax verwendet, während sich Markdown zum Standardformat für Entwicklerplattformen, Dokumentationswerkzeuge, Foren und Issue-Tracker entwickelt hat.

Warum gab es diese Option bisher noch nicht? DokuWiki und Markdown wurden etwa zur gleichen Zeit, im Jahr 2004, eingeführt. DokuWiki entwickelte also unabhängig davon eine eigene Syntax, bevor Markdown weltweit Verbreitung fand und auf Plattformen wie Reddit, Stack Overflow und GitHub Einzug hielt.

Frühere Versuche, Markdown in DokuWiki zu integrieren, stützten sich auf Plugins wie das „Markdowku“-Plugin, das DokuWiki und die Markdown-Syntax mithilfe des bestehenden Parsers kombinierte. Gohr erklärte jedoch, dass eine vollständige Markdown-Unterstützung als Plugin nicht effektiv umgesetzt werden könne und daher in den Kern von DokuWiki integriert werden müsse.

Die Implementierung verfolgt drei Hauptziele: möglichst viele Markdown-Syntaxelemente mit dem DokuWiki-Parser zu unterstützen, den Benutzern die Wahl zwischen DokuWiki-Syntax, Markdown oder einem gemischten Modus zu ermöglichen und das Verhalten anhand bestehender Markdown-Testfälle zu validieren.

Allerdings wird die Funktion zunächst keine vollständige Markdown-Kompatibilität bieten. Gohr merkt an, dass einige Markdown-Funktionen mit dem Ein-Durchlauf-Parser von DokuWiki nur schwer oder gar nicht zu unterstützen sind. So werden beispielsweise die Regeln für Code-Fences vereinfacht, wobei sich die Implementierung auf das gängige Format mit drei Backticks konzentriert.

Zudem wurden einige Funktionen bewusst ausgeschlossen, wie beispielsweise Überschriften im „setext“-Stil, die durch Unterstreichen von Text erstellt werden. Die Formatierung innerhalb von Überschriften, einschließlich fettgedrucktem Text oder Links, wird zunächst ebenfalls nicht unterstützt, um die Kompatibilität mit bestehenden Renderern und Plugins zu gewährleisten.

Derzeit ist die neue Option $conf['syntax'] standardmäßig auf dw gesetzt, sodass die DokuWiki-Syntax weiterhin Standard bleibt. Benutzer, die Markdown-Unterstützung wünschen, müssen diese manuell im Konfigurationsmanager aktivieren. Zukünftig könnte der Installer standardmäßig einen gemischten md+dw Modus verwenden oder es den Benutzern ermöglichen, während der Einrichtung ihre bevorzugte Syntax auszuwählen.

Der zugehörige PR steht zur Überprüfung offen, daher ist die Funktion noch nicht in einer stabilen Version verfügbar. Weitere Details finden Sie in der Ankündigung von Andreas Gohr.

Spendieren Sie Bobby einen ☕ Ko-fi

s3n🧩net wünscht viel Vergnügen