Markdown-Datei

Eine Markdown-Datei ist eine ganz gewöhnliche Textdatei, wie sie ein einfacher Editor speichert. Sie enthält also nur Buchstaben, Ziffern und Satzzeichen, keine verborgenen Formatierungsdaten. Trotzdem lässt sich in ihr eine Struktur ausdrücken: Eine Zeile, die mit einem Rautezeichen beginnt, gilt als Überschrift. Ein Wort zwischen zwei Sternchen wird später fett dargestellt. Diese Vereinbarung, welches Zeichen welche Bedeutung hat, heißt Markdown. Solche Dateien erkennt man meist an der Endung „.md“ am Ende des Dateinamens.

Warum Entwickler lieber Rauten tippen als zu klicken

In einem Textprogramm wie Word steckt die Formatierung unsichtbar in der Datei. Man sieht die fette Schrift, aber nicht, wie sie gespeichert ist. Das macht solche Dateien schwer vergleichbar. Bei Markdown steht dagegen alles offen im Text. Man kann zwei Versionen nebeneinanderlegen und exakt sehen, welches Zeichen sich geändert hat.

Genau das ist der Grund für die große Verbreitung in der Softwarewelt. Programmierer verwalten ihren Code mit Werkzeugen, die jede einzelne geänderte Zeile protokollieren. Dokumentation im Markdown-Format passt perfekt in dieses System. Eine Word-Datei würde dort nur als undurchsichtiger Block auftauchen.

Ein zweiter Vorteil ist die Haltbarkeit. Ein Dateiformat eines bestimmten Programms kann in zwanzig Jahren unlesbar sein. Reiner Text ist das nicht. Eine Markdown-Datei von heute lässt sich noch sehr lange öffnen, notfalls mit dem einfachsten Editor, den ein Computer zu bieten hat.

Die wichtigsten Zeichen und was daraus wird

Die Regeln sind bewusst knapp gehalten. Eine Raute am Zeilenanfang erzeugt eine große Überschrift, zwei Rauten eine kleinere Unterüberschrift. Ein Bindestrich mit Leerzeichen macht aus einer Zeile einen Aufzählungspunkt. Zwei Sternchen um ein Wort bedeuten fett, ein einzelnes bedeutet kursiv. Links schreibt man als Text in eckigen Klammern, gefolgt von der Adresse in runden Klammern.

Damit daraus eine schön gesetzte Seite wird, braucht es ein Zwischenprogramm. Dieser sogenannte Renderer liest die Datei, erkennt die Sonderzeichen und wandelt sie in HTML um. HTML ist die Beschreibungssprache, die jeder Webbrowser versteht. Der Leser sieht am Ende also eine normale Webseite und nie die Rauten und Sternchen.

Ein häufiger Irrtum: Markdown sei eine Programmiersprache. Das ist es nicht. Es wird nichts berechnet und nichts ausgeführt. Markdown beschreibt ausschließlich, wie ein Text gegliedert ist. Die Idee stammt von 2004, und es gibt inzwischen leicht verschiedene Varianten mit Zusätzen wie Tabellen oder Aufgabenlisten.

Von der Chatbot-Antwort bis zur Projektseite

Wer einen Chatbot benutzt, sieht Markdown ständig, ohne es zu merken. Sprachmodelle geben ihre Antworten fast immer in diesem Format aus. Die Oberfläche wandelt es dann sofort in Überschriften und Listen um. Wenn eine Antwort einmal mit Sternchen übersät im Textfeld landet, hat genau diese Umwandlung gehakt.

Auch bei Programmier-Plattformen wie GitHub ist das Format Standard. Jedes Softwareprojekt hat dort eine Datei namens README.md, die erklärt, worum es geht. Ebenso arbeiten Notiz-Apps wie Obsidian damit, weil die Notizen so unabhängig von der App bleiben. Statische Website-Generatoren machen aus einem Ordner voller Markdown-Dateien eine komplette Website.

Für KI-Systeme hat das Format einen zusätzlichen praktischen Wert. Wenn ein Modell Firmendokumente durchsuchen soll, müssen diese erst in verarbeitbaren Text verwandelt werden. Markdown ist dafür ein beliebtes Zwischenformat, weil es die Gliederung eines Dokuments erhält, ohne unnötigen Ballast mitzuschleppen. Überschriften bleiben als Überschriften erkennbar, und das hilft beim sinnvollen Zerlegen langer Texte.