Hintergrund¶

Im Internetzeitalter werden Texte häufig in verschiedenen Formaten benötigt. Ein vorstellbarer Anwendungsfall ist bspw. die Ausarbeitung von Notizen zu einem Blogartikel, der leicht abgeändert als Wikipedia-Artikel publiziert und anschließend mit LaTeX zu einem Aufsatz umgeschrieben wird, bevor er als LibreOffice-Dokument an eine Zeitschrift versandt wird. Die Kernthesen des Aufsatzes werden schließlich in Folienform auf einer Konferenz präsentiert und auf einer Webseite der Öffentlichkeit zugänglich gemacht.

Hier setzt Pandoc an: Es erlaubt die Konvertierung in die erforderlichen Formate. Ausgangsformat ist dabei im Idealfall eine – meist intuitiv verständliche – vereinfachte Auszeichnungssprache wie Markdown oder ReStructuredText.

Eine solche – in einer vereinfachten Auszeichnungssprache geschriebene – Datei (hier im Markdown-Format) kann wie das folgende Beispiel aussehen:

# Markdown-Text

## Abschnitt 1

*Pandoc* kann **Markdown** verarbeiten, eine einfache Markup-Sprache,
aus der von Parsern u.a. HTML- und LaTeX-Dokumente generiert werden
können. Man kann Syntax-Elemente auch "escapen", also bspw. die automatische \*Kursivierung\* verhindern.

Markdown Text beherrscht:

-   Listen unnummeriert
    -   auf mehreren Ebenen verschachteln
    - ... so wie hier
-   Tabellen
-   und vieles mehr

Listen nummeriert:

1.  erste Element
2.  zweites Element

Linien:

- - -

## Abschnitt 2

Außerdem gibt es noch weitere Auszeichnungselemente, bspw. Zitatblöcke:

> "All stories are true ... But this one really happened, if that’s what you mean."

### Abschnitt 2a

Dieses Dokument ist nur ein simples Beispiel!

Wenn man einen Markdown-Editor wie utext 🇬🇧 verwendet, kann man bereits innerhalb eines Vorschaufensters die Auszeichnung verfolgen.

Markdown-Editor utext 🇬🇧 mit Vorschaufenster

Pandoc wandelt diese Datei auf Wunsch bspw. in ein LaTeX-Dokument um. Das Ergebnis einer solchen Umwandlung mit:

pandoc -s -S -f markdown -t latex -o ausgabe.tex eingabe.md 

sieht wie folgt aus:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

\documentclass{article}
\usepackage{amssymb,amsmath}
\usepackage[mathletters]{ucs}
\usepackage[utf8x]{inputenc}
% Redefine labelwidth for lists; otherwise, the enumerate package will cause
% markers to extend beyond the left margin.
\makeatletter\AtBeginDocument{%
  \renewcommand{\@listi}
    {\setlength{\labelwidth}{4em}}
}\makeatother
\usepackage{enumerate}
\usepackage[breaklinks=true,unicode=true,pdfborder={0 0 0}]{hyperref}
\setlength{\parindent}{0pt}
\setlength{\parskip}{6pt plus 2pt minus 1pt}
\setcounter{secnumdepth}{0}


\begin{document}

\section{Markdown-Text}

\subsection{Abschnitt 1}

\emph{Pandoc} kann \textbf{Markdown} verarbeiten, eine einfache
Markup-Sprache, aus der von Parsern u.a. HTML- und LaTeX-Dokumente
generiert werden können. Man kann Syntax-Elemente auch ``escapen'', also
bspw. die automatische *Kursivierung* verhindern.

Markdown Text beherrscht:

\begin{itemize}
\item
  Listen unnummeriert
  \begin{itemize}
  \item
    Mit mehreren Verschachtelungsebenen
  \item
    \ldots{} so wie hier
  \end{itemize}
\item
  Tabellen
\item
  und vieles mehr
\end{itemize}
Listen nummeriert:

\begin{enumerate}[1.]
\item
  erste Element
\item
  zweites Element
\end{enumerate}
Linien:

\begin{center}\rule{3in}{0.4pt}\end{center}

\subsection{Abschnitt 2}

Außerdem gibt es noch weitere Auszeichnungselemente, bspw. Zitatblöcke:

\begin{quote}
``All stories are true \ldots{} But this one really happened, if that's
what you mean.''

\end{quote}
\subsubsection{Abschnitt 2a}

Dieses Dokument ist nur ein simples Beispiel!

\end{document}

An dieser Beispiel-Datei sieht man auch gut, dass sich Pandoc nicht an deutsche Formatierungs- und Maßeinheitskonventionen hält. Bei einer Umwandlung in eine LaTeX-Datei sollte daher das Ergebnis entweder noch manuell korrigiert oder pandoc zusätzliche Angaben zur gewünschten Formatierung (d.h. insbesondere: eine individuelle Präambel) übergeben werden.

Installation¶

Pandoc ist in den offiziellen Paketquellen enthalten. Es muss folgendes Paket installiert ^[1] werden:

• pandoc (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install pandoc 

Oder mit apturl installieren, Link: apt://pandoc

Bedienung¶

pandoc OPTIONEN EINGABEDATEI 

Beispiele¶

pandoc eingabe.md -o ausgabe.odt 

pandoc -f markdown -t odt eingabe.md -o ausgabe.odt 

pandoc -s -S --toc -c ~/.pandoc/format.css eingabe.rst -o ausgabe.html 

pandoc -s -S --toc -c ~/.pandoc/format.css -o ausgabe.html eingabe1.rst eingabe2.rst eingabe3.rst  

pandoc -s -w man eingabe.md -o ausgabe.1 

pandoc -s -t plain -r html http://wiki.ubuntuusers.de/ubuntuusers/Moderatoren/Richtig_fragen -o ausgabe.txt 

% Mein erstes Buch
% Johann Wolfgang von Goethe, Jr.

Das ist mein Buch

# Kapitel 1

Aller Anfang ist schwer.

# Kapitel 2

So long, and thanks for all the fish: Das war's dann auch schon!

pandoc eingabe.txt -o meinbuch.epub 

pandoc eingabe.md -o ausgabe.pdf
pandoc eingabe.txt -o ausgabe.pdf 

markdown2pdf eingabe.md -o ausgabe.pdf 

pandoc -s -S -t mediawiki --toc eingabe.rst -o ausgabe.wiki 

Links¶

• Homepage 🇬🇧

  • Pandoc User’s Guide 🇬🇧 – Offizielle Anleitung

  • Examples 🇬🇧 – Beispiele

  • Creating an Ebook with Pandoc 🇬🇧 – Erstellung eines (mit einer CSS-Datei) formatierten E-Books

• uText: Gelungener Markdown-Editor für Linux 🇩🇪 - grafische Erstellung und Bearbeitung, Blogbeitrag 08/2015

• Folien mit Pandoc erstellen 🇩🇪 - Blogbeitrag, 10/2013

• Markdown Files zu PDF konvertieren 🇩🇪 – Alternative Header für Latex-Dateien einbinden. Blogbeitrag, 04/2010

• Flott durchgereicht - Texte konvertieren mit Pandoc 🇩🇪 – Linux User, 12/2010

• docutils – Umwandlung von Textdateien

• Shell/Anwendungen Übersichtsartikel