!!!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. Dasdas nav-Element bleibt unformatiert.

!!Links
* [Tufte CSS|https://github.com/edwardtufte/tufte-css] CSS zur Verwendung mit Pandoc
* [https://github.com/jez/pandoc-markdown-css-theme]