Quarkdown für Wissenschaft: Formeln, Bibliografie, Cross-References

Hier zeigt Quarkdown, warum der Vergleich mit LaTeX kein Zufall ist. Wissenschaftliches Schreiben verlangt Dinge, an denen normales Markdown vollständig scheitert: gesetzte Formeln, eine zitierfähige Bibliografie, Querverweise auf nummerierte Elemente, Theoreme und Beweise. Quarkdown bringt all das mit — in lesbarer Markdown-Schreibweise statt LaTeX-Befehlssalat. Nach den Daten und Diagrammen aus Teil 5 ist das die akademische Königsdisziplin.

TeX-Formeln

Mathematik wird nativ unterstützt, beim HTML-Rendering über KaTeX. Inline schreibst du Formeln zwischen zwei $ (mit Leerzeichen rundherum):

Sei $ \overline v = \frac {\Delta x} {\Delta t} $ die Durchschnittsgeschwindigkeit.

Eine isolierte Formel wird automatisch zur zentrierten Block-Gleichung. Mehrzeilige Formeln umschließt du — analog zu Code-Fences — mit drei $:

$$$
f(x) =
\begin{cases}
    0 & \text{wenn } x = 0 \\
    1 & \text{wenn } x \neq 0
\end{cases}
$$$

Ein wichtiger Hinweis: Eine Block-Formel unterbricht den Absatz nicht von selbst — ohne Leerzeile davor erkennt Markdown sie als inline. Wer eigene Befehle braucht, definiert TeX-Makros über .texmacro.

Bibliografie und Zitate

Quarkdown bietet CSL-gestützte Bibliografie — und liest die gängigen Formate: BibTeX (.bib), CSL JSON, YAML, EndNote, RIS. Eingebunden wird die Quelle mit .bibliography, zitiert mit .cite {key}:

.bibliography {literatur.bib} style:{apa}

Einsteins Arbeit .cite {einstein} von 1905 revolutionierte die Physik.
Diese Werke .cite {einstein, hawking} sind grundlegend.

Mehrere Schlüssel werden zu einem kombinierten Zitat. Über style wählst du aus dem CSL-Repository — ieee (Default), apa, chicago-author-date, nature und viele mehr. Der Titel der Bibliografie wird über .doclang automatisch lokalisiert; Überschrift, Seitenumbruch und Aufnahme ins Inhaltsverzeichnis steuerst du per Parameter.

Cross-References

In der Typografie verweist man auf Abbildungen, Tabellen, Abschnitte und Gleichungen — und zwar mit ihrer Nummer, nicht mit „siehe oben". Quarkdown macht das mit .ref {id}. Du vergibst eine ID per {#id}, und .ref darf vor oder nach dem Ziel stehen:

Sobald Quarkdown installiert ist, siehe .ref {getting-started}.

## Erste Schritte {#getting-started}

Dasselbe Muster trägt für Abbildungen (![…](…) {#logo}), Tabellen, Gleichungen ($ E = mc^2 $ {#energy}) und Code-Blöcke (```kotlin {#main}). Bei Überschriften wird die Referenz-ID im HTML zugleich zum id-Attribut — praktisch für direkte Links. Querverweise funktionieren am besten, wenn die Ziele nummeriert sind.

Automatische Nummerierung

Die .numbering-Funktion ist die zentrale Stellschraube. Sie nummeriert Überschriften, Abbildungen, Tabellen, Gleichungen, Code-Blöcke und Fußnoten — gesteuert über ein Dictionary, in dem jedes Zeichen ein Zähler oder festes Symbol ist:

.numbering
    - headings: 1.A.a
    - figures: 1.1
    - tables: 1.1

1 ist dezimal, a/A lateinische Buchstaben, i/I römische Zahlen; alles andere ist ein festes Symbol. paged-Dokumente bringen sinnvolle Defaults schon mit. Zwei Feinheiten: Abbildungen werden nur mit (auch leerer) Caption nummeriert, Gleichungen nur mit Cross-Reference-ID (Konvention {#_}, wenn nummeriert, aber nirgends referenziert). Mit .numbered {key} lässt sich sogar jedes eigene Element in eine nummerierte Serie aufnehmen.

Die Paper-Bibliothek

Den akademischen Werkzeugkasten komplettiert die eingebaute, selbst in Quarkdown geschriebene paper-Bibliothek. Eingebunden per .include {paper}, liefert sie die klassischen LaTeX-Strukturen:

.include {paper}

.abstract
    Hier steht die Zusammenfassung des Dokuments.

.definition
    Sei $ \Delta x $ die Positionsänderung über ein Intervall $ \Delta t $,
    dann ist die Durchschnittsgeschwindigkeit $ v = \frac {\Delta x} {\Delta t} $.

.theorem
    ...

.proof
    ...

Es gibt .abstract, .definition, .lemma, .theorem und .proof — allesamt betitelt und, sobald du ein Nummerierungsformat (definitions, lemmas, theorems, proofs) setzt, automatisch durchnummeriert. Beweise enden mit dem klassischen ∎-Zeichen (anpassbar über .proofend). Mehr LaTeX-Gefühl bekommst du in Markdown nirgends.

FAQ

Brauche ich LaTeX installiert?

Nein. Die Formeln rendert KaTeX im Browser, die Bibliografie verarbeitet Quarkdown selbst über CSL. Du brauchst kein TeX-Distribution und keine Toolchain — nur Quarkdown. Das ist der ganze Sinn: LaTeX-Ergebnisse ohne LaTeX-Einrichtung.

Wie halte ich Zitate konsistent?

Über den style-Parameter der Bibliografie. Ein Wechsel von ieee zu apa formatiert alle Zitate und das Literaturverzeichnis um — du änderst eine Zeile, nicht hundert Fußnoten.

Warum wird meine Abbildung nicht nummeriert?

Weil ihr die Caption fehlt. Quarkdown nummeriert Abbildungen nur, wenn sie eine — notfalls leere — Bildunterschrift haben. Bei Gleichungen ist es analog die Cross-Reference-ID.

Weiterlesen

Die datengetriebene Seite davor behandelt Teil 5: Tabellen und Diagramme. Als Nächstes wechseln wir das Format komplett: Präsentationen — Folien, interaktive Fragmente und Speaker-Notes. Die vollständige Referenz zu Formeln, Bibliografie und Nummerierung steht in der offiziellen Wiki.