Was ist Markdown

Mark..haeh? Was´n das schon wieder?

MuT-Schwierigkeit: Nur einen Editor verwenden

MuT-Schwierigkeit: Mit Pandoc auf der Kommandozeile arbeiten

Markdown ist eine Auszeichnungssprache für das Schreiben von Texten. Durch das Voranstellen von Sonderzeichen oder das Einfassen von Text durch Sonderzeichen in einem MD-Text wird festgelegt, wie der Text später aussehen soll. Hat man den Text dann im Markdown-Format geschrieben, hat man die Möglichkeit mit Hilfe von Programmen, so genannten Parsern, diesen in andere Text-Formate zu übersetzten (HTML, DOCX, PDF).
Was ist der Vorteil einen Text erst in Markdown zu schreiben und dann mit einem extra-Programm zu “übersetzten”:

• Der meist genannte Grund ist, das es weniger ablenkend ist, mit den reduzierten Möglichkeiten von Markdown einen Text zu schreiben. (Der MuT-Fachberater mag das)
• ein weiterer Grund ist (eigentlich der wichtigste) die Übertragbarkeit. In einer MD-Datei bleiben die Informationen auch ohne die richtige Software lesbar.

Macht man eine Word-Datei in einem Texteditor auf, in der nur das Wort FETT in fett geschrieben ist, sieht das in so aus:

Dagegen sieht es in einer Markdown-Datei so aus:

Die Information ist also auch dann noch zugänglich, wenn nicht die richtige Software vorhanden ist (aus diesem Grund sind README-Dateien oft in Markdown geschrieben).

Aber wie funktioniert des jetzt:

Für ein paar wenige Formatierungen gibt es eine Syntax an Sonderzeichen, mit denen man das spätere Aussehen festlegt:

Zum Beispiel wird aus **FETT** im Markdown
dann FETT in HTML, Word oder im PDF.

Eine Liste der möglichen Formatierungen gibt es zum Beispiel auf der Wikipedia-Seite zu Markdown und vielen anderen Seiten im Internet.

Der Parser

Auch wenn es MD-Editoren gibt, die einen Export direkt in Word oder HTML ermöglichen, ist der eleganteste Weg eine MD-Datei umzuwandeln ein Parser-Tool. Allerdings ist dazu ein wenig Einarbeitung nötig. Vor allem der viel genutzte Parser pandoc ist als Kommandozeilen-Tool nicht selbsterklärend, dafür aber sehr mächtig (er kann nicht nur MD in Word oder PDF umwandeln, sondern fast jedes Textdokument in ein anderes).

Editoren

Natürlich könnte man eine MD-Datei auch einfach in einem einfachen Text-Editor schreiben, aber es gibt auch eine vielzahl an speziellen Editoren für MD. Zum einen helfen einem diese dabei der Syntax, wenn man diese am Anfang noch nicht beherrscht und zum anderen bieten manche davon auhc gleich eine Exportfunktion, ohne das man dann einen Parser braucht.

Links und Co

• Eine ausführliche Einführung in MD kann man auf der Seite The Markdown Guide finden (in Englisch).
• Eine Liste von Editoren findet sich auf der Seite des Providers Ionos.
• Nicht dabei ist mein Lieblingseditor Ghostwriter, der außer einer HTML-Vorschau und dem Export nach HTML sehr rudimentät ist.
• Auf der Pandoc -Seite kann man nicht nur den Parser selbt runterladen, sondern erfährt auch welche Formate er noch unterstützt.

Der letzte Tipp

Wer sich nicht mit Parsern oder der Suche nach einem Editor mit de richtigen Exportversion rimschlagen möchte. Der Export nach HTML ist fast immer möglich, und deine HTML-Datei lässt sich immer in ein Word-Dokument importieren.

---

Geschrieben in Ghostwriter