Kapitel 10: Pandoc - Der Dokumenten-Konverter

In diesem Kapitel lernen Sie, wie Sie Markdown mit Pandoc in verschiedene Formate konvertieren.

10.1 Was ist Pandoc?

Pandoc ist ein mächtiges Kommandozeilen-Tool zum Konvertieren von Dokumenten zwischen verschiedenen Formaten. Es wird oft als der "Schweizer Taschenmesser" für Dokumentkonvertierung bezeichnet.

Unterstützte Formate

Input:

• Markdown, HTML, LaTeX, reStructuredText, AsciiDoc, und viele mehr

Output:

• PDF, Word (.docx), HTML, ePub, LaTeX, und viele mehr

10.2 Installation

Windows

# Mit Chocolatey
choco install pandoc

# Manuell
# Laden Sie den Installer von https://pandoc.org/installing.html herunter

macOS

# Mit Homebrew
brew install pandoc

Linux

# Ubuntu/Debian
sudo apt install pandoc

# Fedora
sudo dnf install pandoc

10.3 Grundlegende Nutzung

Markdown zu HTML

pandoc input.md -o output.html

Markdown zu PDF

# Benötigt LaTeX-Installation (z.B. TeX Live, MiKTeX)
pandoc input.md -o output.pdf

Markdown zu Word (.docx)

pandoc input.md -o output.docx

Markdown zu ePub

pandoc input.md -o output.epub

10.4 Fortgeschrittene Optionen

Metadaten angeben

pandoc input.md -o output.pdf --metadata title="Mein Titel" --metadata author="Max Mustermann"

Oder in der Datei mit YAML Front Matter:

---
title: Mein Titel
author: Max Mustermann
date: 2024-01-15
---

Inhaltsverzeichnis einfügen

pandoc input.md -o output.pdf --table-of-contents

Eigenes CSS (für HTML)

pandoc input.md -o output.html --css=style.css

Template verwenden

pandoc input.md -o output.pdf --template=mein-template.tex

10.5 Pandoc für akademische Arbeiten

Zitationen verwalten

Pandoc unterstützt Bibliographien:

pandoc input.md -o output.pdf --bibliography=bibliography.bib

Beispiel bibliography.bib:

@book{smith2020,
  author = {Smith, John},
  title = {Markdown für Akademiker},
  year = {2020},
  publisher = {Beispielverlag}
}

In input.md:

Wie Smith (2020) gezeigt hat...

# Literaturverzeichnis

Footnotes

Pandoc unterstützt Fußnoten:

Das ist ein Text mit einer Fußnote[^1].

[^1]: Das ist der Inhalt der Fußnote.

10.6 Pandoc für Präsentationen

reveal.js (HTML-Präsentationen)

pandoc input.md -o presentation.html -t revealjs

PowerPoint

pandoc input.md -o presentation.pptx

LaTeX Beamer (PDF-Präsentationen)

pandoc input.md -o presentation.pdf -t beamer

10.7 Pandoc Filters

Pandoc kann mit Filtern erweitert werden, um die Konvertierung anzupassen.

Beispiel: Filter installieren

# Pandoc Filter für Zitationen
pip install pandoc-citeproc

Filter verwenden

pandoc input.md -o output.pdf --filter pandoc-citeproc

10.8 Pandoc in der Praxis

Dokumentation generieren

# Mehrere Markdown-Dateien zusammenführen
pandoc chapter1.md chapter2.md chapter3.md -o buch.pdf

Webseiten generieren

# Mehrere Dateien in eine HTML-Seite konvertieren
pandoc *.md -o website.html --toc --standalone

Bücher schreiben

Mit Pandoc und LaTeX können Sie ganze Bücher schreiben:

pandoc cover.md vorwort.md kapitel*.md appendix.md -o buch.pdf --table-of-contents --number-sections

10.9 Zusammenfassung

In diesem Kapitel haben Sie gelernt:

• ✅ Was Pandoc ist und wie man es installiert
• ✅ Grundlegende Konvertierungen (Markdown → HTML, PDF, Word)
• ✅ Fortgeschrittene Optionen (Metadaten, Inhaltsverzeichnis)
• ✅ Pandoc für akademische Arbeiten (Zitationen, Fußnoten)
• ✅ Pandoc für Präsentationen
• ✅ Pandoc Filter

Im nächsten Kapitel werden wir lernen, wie man Markdown für Notizen und Wissensmanagement (mit Obsidian, Notion, Joplin) verwendet!

---

Übung: Installieren Sie Pandoc und konvertieren Sie eine Ihrer bisherigen Markdown-Dateien in:

1. HTML
2. Word (.docx)
3. PDF (wenn LaTeX installiert ist)