Markdown für wissenschaftliche Arbeiten mit Pandoc

Warum Markdown statt LaTeX direkt

LaTeX ist seit 40 Jahren der Standard für wissenschaftliches Schreiben. Aber die Syntax ist verbose und schwer zu lesen. `\section{Einleitung}` statt Markdown `# Einleitung`. `\textbf{wichtig}` statt `**wichtig**`. Im Markdown-Quelltext siehst du den Inhalt direkt.

Pandoc-Markdown deckt 95% der LaTeX-Features ab, die in typischen wissenschaftlichen Texten gebraucht werden. Fett, Kursiv, Listen, Tabellen, Math-Formeln, Footnoten, Citations. Was fehlt: tiefer LaTeX-Code wie eigene Makros oder TikZ-Diagramme. Für 95% der Promotionen reicht Pandoc-Markdown.

Setup: Pandoc und LaTeX installieren

Du brauchst Pandoc selbst und einen LaTeX-Compiler (für PDF-Output). Auf macOS: `brew install pandoc` und `brew install --cask basictex`. Auf Linux: `apt install pandoc texlive-latex-recommended`. Auf Windows: pandoc.org Installer plus MiKTeX Installer.

Optional: ein Editor mit Markdown-Live-Preview. Online-Tools wie unserer für schnelle Drafts. Desktop-Editoren wie Mark Text oder iA Writer für längere Texte. Obsidian für vernetzte Notizen mit Citations.

Citation-Workflow mit BibTeX

Citations sind das wichtigste wissenschaftliche Feature. Du speicherst Quellen in einer .bib-Datei (BibTeX-Format). Im Markdown verweist du mit `[@autor2024]`. Pandoc löst diese Verweise auf und generiert das Bibliography am Dokument-Ende.

BibTeX-Eintrag sieht so aus: `@article{einstein1905, title={Zur Elektrodynamik bewegter Körper}, author={Einstein, Albert}, journal={Annalen der Physik}, year={1905}}`. Du kannst Einträge manuell schreiben oder aus Zotero, Mendeley, Citation-Managern exportieren.

Im Text: `Wie Einstein zeigte [@einstein1905], ist die Lichtgeschwindigkeit konstant`. Pandoc rendert: `Wie Einstein zeigte (Einstein 1905), ist die Lichtgeschwindigkeit konstant` plus Eintrag im Literaturverzeichnis.

Konkreter Pandoc-Befehl

Der Workflow ist ein einzeiliger Terminal-Befehl. `pandoc paper.md -o paper.pdf --citeproc --bibliography=refs.bib --csl=apa.csl`.

Erklärung: `paper.md` ist deine Markdown-Quelle, `paper.pdf` der Output, `--citeproc` aktiviert Citation-Verarbeitung, `--bibliography=refs.bib` zeigt auf deine BibTeX-Datei, `--csl=apa.csl` wählt einen CSL-Citation-Style (APA, MLA, Chicago, etc.).

Erstes Mal kompiliert: ein paar Sekunden Wartezeit, dann hast du ein PDF mit korrekter Bibliography. Bei Aenderungen am Text einfach Befehl wiederholen.

Math-Formeln pixel-perfekt

Pandoc unterstützt LaTeX-Math-Syntax in Markdown. `$E=mc^2$` als Inline-Formel, `$$\int_a^b f(x) dx$$` als Block-Formel. Beim PDF-Output wird das über LaTeX gerendert — pixel-perfekt.

Komplexe Formeln funktionieren genauso wie in reinem LaTeX. Matrizen, Brüche, Summen, Integrale, griechische Buchstaben — alles direkt schreibbar in Markdown.

Vorteil gegenüber reinem LaTeX: du hast den Markdown-Text drum herum lesbar im Source. Du musst nicht zwischen `\section{...}` und Math-Block hin- und herwechseln.

Templates und Styling

Pandoc kann eigene LaTeX-Templates nutzen. Du erstellst ein .tex-Template mit deinem Layout (Schriftgröße, Margins, Header-Footer), und Pandoc fügt deinen Markdown-Inhalt rein.

Beispiel: deine Uni verlangt Times New Roman, 12pt, 1.5 Zeilenabstand, 2.5cm Margins. Du erstellst einmalig ein Template mit diesen Einstellungen, alle deine Markdown-Texte kompilieren in dieses Layout.

Vorgefertigte Templates: Eisvogel ist beliebt für technische Berichte. Wandmal-Markdown-Template für Doktorarbeiten. GitHub durchsuchen nach "pandoc latex template".

Cross-References und Inhaltsverzeichnis

Wissenschaftliche Texte brauchen Cross-References — "siehe Abbildung 3.2" oder "in Abschnitt 4.1 erwähnt". Pandoc-Filter `pandoc-crossref` aktiviert das.

Im Markdown: Abbildung mit `{#fig:experiment}`, Verweis mit `siehe @fig:experiment`. Pandoc generiert "siehe Abbildung 3.2" automatisch, basierend auf der tatsächlichen Nummerierung.

Inhaltsverzeichnis: `pandoc --toc paper.md -o paper.pdf` fügt ein automatisch generiertes TOC am Anfang ein. Tiefe regelbar mit `--toc-depth=3`.

Multi-File-Projekte

Lange Doktorarbeiten teilst du in mehrere Markdown-Dateien (ein pro Kapitel). Pandoc kompiliert sie zusammen: `pandoc chapter-1.md chapter-2.md chapter-3.md -o thesis.pdf`.

Vorteil: jedes Kapitel ist separat editierbar, kürzer und übersichtlicher. Du kannst ein Kapitel solo compilieren für schnelle Iteration, und am Ende alles zusammen.

Mit Makefile oder einfachen Shell-Skripten automatisierst du das. `make thesis.pdf` ruft Pandoc auf, schaut welche .md-Dateien sich geändert haben, kompiliert neu.

Wann Pandoc-Markdown nicht reicht

Bei sehr komplexen LaTeX-Anforderungen — TikZ-Diagramme, eigene Klassen-Files, mehrspaltige Layouts mit komplexen Floats — kommst du an Grenzen.

Lösung: schreibe den Hauptteil in Markdown, weiche für komplexe Stellen auf LaTeX-Code aus. Pandoc-Markdown erlaubt eingebettete LaTeX-Blöcke, die direkt durchgereicht werden.

Praxis-Beispiel: deine Doktorarbeit hat ein TikZ-Diagramm pro Kapitel. Du schreibst das TikZ-Code in Markdown mit `\begin{tikzpicture}...\end{tikzpicture}`. Pandoc behält das beim PDF-Output und LaTeX rendert es.

Häufige Fragen