Pandoc#

Pandoc ist ein WErkzeug für die Linux-Kommandozeile, mit dem man Markddown-Dateien in HTML oder PDF umwandeln kann.

Pandoc beherrscht darüber hinaus eine Vielzahl von Eingabe- und Ausgabeformaten. Ich will hier notieren, wie ich schnell und einfach Markdown in HTML umwandele.

 pandoc markup-text.md -s --metadata title="Titel meiner HTML Seite" -o index.html

markup-text.md

ist meine Markdown-Eingabedatei

-s

sorgt für die Ausgabe einer kompletten HTML-Datei (sonst wird nur ein Fragment erzeugt)

--metadata title="..."

sorgt für den Inhalt des title-Elements im HTML-Header

-o index.html

Name der Ausgabe-Datei

Das erzeugte HTML enthält Inline-CSS und sieht recht gut aus. Man kommt aber an Grenzen, sobald man mit --toc zusätzlich ein Inhaltsverzeichnis als Navigation einbettet. Das nav-Element bleibt unformatiert.

Links#

• Tufte CSS CSS zur Verwendung mit Pandoc
• https://github.com/jez/pandoc-markdown-css-theme