Quarkdown 2.0.0 erschienen: Sandbox-Berechtigungen und Offline-HTML

Der Markdown-Dialekt Quarkdown ist in Version 2.0.0 erschienen. Im Mittelpunkt des Updates stehen ein neues Berechtigungssystem, das den Zugriff eines Dokuments während der Kompilierung einschränkt, und eine HTML-Ausgabe, die vollständig offline funktioniert. Hinzu kommen paralleles Rendering, neue HTML-Optionen für Canonical Links und eine sitemap.xml sowie ein public/-Verzeichnis für statische Assets. Mehrere Breaking Changes betreffen außerdem das Standard-Ausgabeverzeichnis, den Namen des Ausgabeverzeichnisses bei --preview und ein umbenanntes Modul der Standardbibliothek.

Quarkdown erweitert die Auszeichnungssprache um eine Turing-vollständige Funktionssprache. Anders als klassisches Markdown erlaubt das Open-Source-Projekt damit Variablen, Funktionen und Kontrollstrukturen direkt im Dokument. Es zielt auf HTML- und PDF-Ausgaben für Bücher, Fachtexte, Wissenssammlungen und Präsentationen.

Die wichtigste Neuerung ist das Berechtigungssystem. Es legt fest, worauf ein Dokument während der Kompilierung zugreifen darf. Freigaben und Verbote setzen Nutzer über --allow und --deny. Das Feature wirkt vor allem als Sandbox: Weil Quarkdown-Dokumente deutlich mehr können als reines Markdown, lässt sich die Ausführung fremder Dokumente damit besser absichern.

Ebenfalls zentral ist die überarbeitete HTML-Ausgabe. Quarkdown liefert Schriften, Code-Highlighting-Themes und optionale Bibliotheken jetzt mit der Installation aus, statt sie von CDNs oder Google Fonts nachzuladen. Damit funktioniert die Ausgabe vollständig offline. Dies sorgt für vorhersagbareres Rendering und schnellere Seitenaufrufe.

Für HTML-Projekte führt Quarkdown die neue Funktion .htmloptions ein. Mit gesetztem baseurl erzeugt sie Canonical Links und schreibt eine sitemap.xml. Zudem landet der Inhalt des neuen public/-Verzeichnisses unverändert im Wurzelverzeichnis der Ausgabe. Ergänzend versteht Quarkdown beim HTML-Export jetzt das Wurzelpfadsymbol @.

Neu ist zudem die Primitivfunktion .image zur feineren Bildkonfiguration. Querverweise per .ref rendert Quarkdown jetzt für alle referenzierbaren Typen als Links. Zu den weiteren Komfortfunktionen zählen mehrzeilige Funktionsaufrufe und die neue Funktion .keybinding für Tastenkürzel.

Unter der Haube rendert Quarkdown 2.0 Geschwisterelemente parallel. Bestehende Setups müssen sich auf einige Inkompatibilitäten einstellen: Das Standard-Ausgabeverzeichnis heißt jetzt ./quarkdown-output, und das Modul Injection wurde in Html umbenannt.

Das Projekt ist Open Source und unter GNU GPLv3 beziehungsweise GNU AGPLv3 lizenziert. Die Software ist über gängige Paketmanager wie Homebrew oder Scoop installierbar.