# Quarkdown für Wissenschaft: Formeln, Bibliografie, Cross-References > Teil 6 der Quarkdown-Reihe: TeX-Formeln mit KaTeX, CSL-Bibliografie und Zitate, Cross-References, automatische Nummerierung und die Paper-Bibliothek mit Theoremen und Beweisen. Source: https://www.jpkc.com/db/blog/quarkdown-wissenschaftliches-schreiben/ 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](https://www.jpkc.com/db/blog/quarkdown-daten-diagramme/) ist das die akademische Königsdisziplin. ## TeX-Formeln Mathematik wird nativ unterstützt, beim HTML-Rendering über [KaTeX](https://www.katex.org). **Inline** schreibst du Formeln zwischen zwei `$` (mit Leerzeichen rundherum): ```markdown 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 `$`: ```markdown $$$ 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}`: ```markdown .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](https://citationstyles.org)-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: ```markdown 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: ```markdown .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: ```markdown .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](https://www.jpkc.com/db/blog/quarkdown-daten-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](https://quarkdown.com/wiki).