Text und Code in derselben Datei

Ein technisches Dokument mit Daten entsteht meist so: Im Notizbuch entsteht eine Abbildung, sie wird als Bild ausgegeben, in ein Textprogramm gezogen und dort gesetzt, und sobald sich die Daten aendern, beginnt alles von vorn. Genau dieses Hin und Her will Quarto abschaffen. Das Werkzeug wird von Posit gepflegt, steht auf Pandoc und versteht sich als offenes System fuer wissenschaftliches und technisches Publizieren. Die Autorin pflegt eine reine Textdatei mit der Endung qmd, erzaehlender Text und ausfuehrbare Codebloecke liegen in derselben Datei, beim Rendern laeuft der Code zuerst, Abbildungen und Zahlen fuellen sich an Ort und Stelle ein, und Pandoc macht daraus das fertige Stueck.

Der Gewinn liegt nicht in ein paar gesparten Klicks, sondern darin, dass die Herkunft jedes Ergebnisses nachvollziehbar bleibt. Jede Zahl und jede Abbildung im Dokument entspricht einem Stueck Code in der Datei, eine Datenaktualisierung heisst also erneut rendern, und die Lage, in der der Text ein Ergebnis vom Maerz nennt, waehrend die Abbildung noch February zeigt, kann nicht entstehen. Fuer Berichte und technische Dokumente, die ueber Jahre gepflegt werden, ist das nuetzlicher als ein schoenes Layout.

Eine Quelle, mehrere Fertigprodukte

Die Ausgabeformate reichen weit: HTML Seiten, PDF, Textdateien, ePub Buecher und Praesentationen auf revealjs Basis, dazu die Moeglichkeit, mehrere Dokumente zu einer Webseite, einem Blog oder einem Buch zu ordnen. Eine Quelle darf mehrere Zielformate gleichzeitig nennen, damit muessen Fassung fuer die Leinwand und Fassung fuer den Druck nicht mehr getrennt gepflegt werden. Geschrieben wird im Markdown Dialekt von Pandoc, wo Formeln, Zitate, Querverweise, Abbildungstafeln, Hinweiskaesten und fortgeschrittenes Seitenlayout auf der Ebene der Syntax unterstuetzt werden, und die Nummerierung von Abbildungen laeuft beim Hinzufuegen und Loeschen automatisch mit, was die haendische Nummerierung ersetzt, die in langen Dokumenten am haeufigsten schiefgeht.

Die Ausfuehrung von Code ist nicht an eine Sprache gebunden. Python, R, Julia und Observable JavaScript stehen direkt in Codebloecken, die Engine wird beim Rendern passend gewaehlt, und ein Jupyter Notizbuch laesst sich unveraendert rendern. Auch beim Editor gibt es keine Vorgabe: VS Code, Positron, RStudio und JupyterLab funktionieren, ein visueller Markdown Editor wird angeboten, und wer reinen Text mag, kommt mit einem beliebigen Editor plus Kommandozeile genauso weit.

Version 1.11 repariert das Fundament

Quarto 1.11 erschien am 2. November 2026, frueher als gewohnt, und der Grund war eine Sicherheitsaktualisierung. Die mitgelieferte Deno Laufzeit wandert von 2.7.14 auf 2.9.8, und die neue Fassung weist Zertifikate zurueck, die die bereits geknackten Ketten von eMudhra und emSign tragen. Die Wirkung liegt beim Veroeffentlichen und beim Holen: quarto publish, quarto add und quarto use template sowie die TypeScript Skripte, die Quarto ausfuehrt, gehen alle ueber HTTPS Anfragen, und eine aeltere Fassung, die diesen Zertifikaten vertraute, gab einem Angreifer im selben Netz die Gelegenheit, eine Seite nachzuahmen. Das Projekt sagt ausdruecklich, dass die Korrektur nicht in die 1.10 Reihe zurueckgetragen wird, der Weg dorthin fuehrt also nur ueber 1.11.

Der Preis ist eine etwas hoehere Schwelle bei der Maschine. Das mitgelieferte Deno 2.9.8 verlangt unter macOS Version 12 oder neuer, aeltere Systeme muessen zuerst hochgezogen werden, sonst starten die Rendering Engine und die davon abhaengenden Formate unter Umstaenden nicht.

Bei der Barrierefreiheit ist viel passiert

Die andere Haelfte von 1.11 liegt bei der Barrierefreiheit, und die Aenderungen sitzen dort, wo sie wirklich gebraucht werden. HTML Dokumente mit Bootstrap Thema, dazu Webseiten, Buecher und Dashboards, bekommen einen Sprung zum Hauptinhalt, sodass Tastaturnutzung nicht mehr durch die ganze Navigation tabben muss. Bereiche der Seitenleiste werden zu Schaltflaechen, die sich mit der Tastatur bedienen lassen. Scrollbare Codebloecke und Ausgabebereiche koennen in Safari den Fokus nehmen und scrollen. Die Einblendungen hinter Zitaten, Fussnoten, Querverweisen und Codeanmerkungen schliessen mit Esc. Sichtbar gibt es einen neuen zweifarbigen Fokusring, der auch im erzwungenen Kontrastmodus erkennbar bleibt.

Auch Abbildungen und Praesentationen sind bedacht. Diagramme aus Mermaid und Graphviz uebernehmen jetzt den in fig-alt angegebenen Ersatztext, und das gilt fuer HTML, revealjs, Word und Typst, wobei der Ersatztext von der sichtbaren Bildunterschrift getrennt bleibt und die beiden sich nicht mehr verdraengen. In der normalen Ansicht haelt eine Praesentation den Tastaturfokus auf der aktuellen Folie, ein Screenreader kuendigt noch nicht sichtbare Schritte nicht vorab an, und beim Wechsel auf einen anderen Browsertab geht der Fokus nicht verloren.

Zuwachs entlang Typst und Julia

Wer mit Typst setzt, kann jetzt mit den beiden Optionen lof und lot Verzeichnisse der Abbildungen und Tabellen erzeugen, die Ueberschrift folgt der Sprache des Dokuments und laesst sich ueber crossref anpassen. Die Bloecke proof, remark und solution steigen von reinem Text auf Lehrsatz Gestaltung um, beschriftete Bloecke lassen sich querverweisen. Auch die Schreibweise fuer Definitionslisten ist geklaert, naemlich ein definition-list Behaelter mit einer verschachtelten Aufzaehlung, und das ist die Syntax, die die naechste grosse Fassung beibehalten wird.

Die Julia Engine bekommt eine Option keep-ipynb, sodass ein ausgefuehrtes Notizbuch neben der Quelle gespeichert werden kann, und sie behebt sowohl ein haengendes Ausfuehren von Notizbuechern als auch den Fall, dass eine Aenderung der Metadaten zwischengespeicherte Zellenergebnisse nicht ungueltig machte. Geteilte Metadaten erreichen Pandoc Vorlagen und Lua Filter nun als zusammengefuehrter Wert, eine geerbte Liste wie keywords verschmilzt also mit den eigenen Werten des Dokuments, statt von der Liste im Dokument ganz ersetzt zu werden.

Fuer wen es passt, und fuer wen nicht

Die Komfortzone ist klar: Menschen, die Code, Ergebnisse und Erklaerung zusammen schreiben muessen. Datenanalysen, Versuchsprotokolle, Kursunterlagen, technische Handbuecher und Buecher, die ueber Jahre leben, haben alle die harte Anforderung, dass ein Ergebnis auf die Berechnung dahinter zurueckfuehrbar ist, und das Modell mit einer einzigen Quelle antwortet genau darauf. Wo ein Team schon in RStudio oder Jupyter arbeitet, faellt der Aufwand beim Umzug vor allem beim Einarbeiten in die YAML Optionen an, die Syntax selbst ist nicht schwer.

Wer nur eine saubere Dokumentationsseite will und auf der Seite keinen Code hat, der laufen muss, fuer den wirkt der Konfigurationsaufwand von Quarto ueberfluessig, und eine leichtere statische Loesung reicht. Der Weg ueber PDF haengt weiterhin an einer LaTeX Umgebung, und deren Fehlermeldungen sind fuer Neueinsteiger nicht freundlich; wer auf das Typst Format wechselt, umgeht diese Schicht, bekommt aber ein juengeres Oekosystem. Auch die Renderzeit verdient einen Gedanken, denn ein Projekt mit viel Rechnung braucht Einfrieren und Zwischenspeicher, sonst wiederholt jeder Neuaufbau die Arbeit.

Gelesen an 1.11 hat sich der Schwerpunkt vom Anhaeufen von Funktionen zum Schleifen der Zuverlaessigkeit verschoben: Zertifikatsketten, Barrierefreiheit, Zwischenspeicher ueber Sprach Engines hinweg sind alles Schmerzen, die nur langjaehrige Nutzer treffen. Fuer alle, die es schon einsetzen, ist der Sicherheitsfix der Grund fuer das Update. Wer noch zuschaut, sollte zuerst einen Bericht, den er ohnehin schreibt, einmal rendern und sehen, ob eine einzige Quelldatei den heutigen Flickenteppich ersetzen kann.