thinkretro.de

Dez 01, 2014

Blogartikel mit Vim, Markdown und Pandoc erstellen

Seitdem mich ein Freund auf das Konvertierungstool Pandoc aufmerksam gemacht hat, mit dem man bspw. Markdown-Dokumente ganz einfach nach Html konvertieren kann, schreibe ich meine Blogartikel komplett in Markdown.

Markdown - die Basics

Markdown ist eine von vielen Auszeichnungssprachen, die es ermöglichen mit einer überschaubaren Anzahl an Elementen Text zu formatieren. Ziel ist hierbei, dass schon das Markdown-Dokument ohne weitere Konvertierung leicht lesbar und verständlich ist. Dabei ist die Syntax relativ leicht zu lernen und nicht wirklich kompliziert. Hier gibt es einen guten Überblick. Darüber hinaus findet man auch über die Google Suche das ein oder andere Cheatsheet, das die wichtigsten Elemente kurz zusammenfasst.

Vim Markdown

Für meinen momentanen Lieblingseditor Vim gibt es ein nettes Plugin, welches den Umgang mit Markdown-Texten ziemlich vereinfacht. Hier gibt es das Plugin

Pandoc

Um aus meinem zuvor erstellten Markdown-Dokument ein gültiges Html-Dokument zu machen, bedarf es noch einer Umwandlung mittels pandoc. Pandoc selbst ist in den Debian Paketquellen vorhanden und lässt sich mittels #apt-get install pandoc installieren. Um das vorhandene Markdown-Dokument in ein Html-Dokument umzuwandeln genügt ein $pandoc -o testseite.html markdown-dokument.md.

Fazit

Mit der Kombination aus Vim + Markdown + Pandoc ist es mir relativ leicht möglich Artikel für meine Website zu schreiben. So kann ich das Ergebnis als Html-Quelltext im Anschluss in meinen Wordpress-Editor laden und dort den letzten Feinschliff vornehmen. Dadurch, dass Markdown-Dateien im Prinzip nur Textdateien sind, lassen sie sich zudem wunderbar mit Tools wie bspw. 'grep' auf Kommandozeilenebene durchsuchen.