Markdown ist eine leicht lesbare Auszeichnungssprache für strukturierten Klartext. Überschriften, Listen, Links, Hervorhebungen und Codeblöcke werden mit wenigen Zeichen beschrieben. Aus demselben Text kann anschliessend HTML, ein Dokument oder eine andere Darstellung erzeugt werden.
Der Inhalt bleibt auch ohne Spezialsoftware verständlich. Darin liegt der wichtigste Unterschied zu Formaten, deren Struktur erst durch eine bestimmte Anwendung sichtbar wird.
Inhalt und Darstellung bleiben getrennt
Markdown beschreibt, welche Rolle ein Abschnitt besitzt. Eine Zeile mit `#` ist eine Überschrift, `-` beginnt einen Listenpunkt und eckige sowie runde Klammern bilden einen Link. Farben, Schriftgrössen und Abstände bestimmt dagegen das Ausgabesystem.
Diese Trennung erlaubt, denselben Inhalt auf einer Website anders darzustellen als in einem Handbuch, ohne zwei Textfassungen pflegen zu müssen. Sie schützt jedoch nicht vor schlechtem Aufbau: Eine technisch korrekte Überschrift ersetzt keine verständliche Gliederung.
Nicht jedes Markdown ist gleich
Markdown entstand ohne vollständig verbindliche Spezifikation. Plattformen ergänzten deshalb eigene Tabellen, Fussnoten, Aufgabenlisten oder besondere Codeblöcke. Die CommonMark-Spezifikation definiert einen präzisen gemeinsamen Kern und reduziert Unterschiede zwischen Implementierungen.
Vor einer Veröffentlichung sollte feststehen, welchen Dialekt der Renderer unterstützt. Ein Dokument kann sonst in einem Editor richtig aussehen und an anderer Stelle anders interpretiert werden.
Weshalb Klartext langfristig nützlich ist
Markdown-Dateien sind klein, portabel und mit gewöhnlichen Textwerkzeugen lesbar. Sie lassen sich durchsuchen, vergleichen und automatisiert prüfen. In Verbindung mit Git wird jede Textänderung als Diff sichtbar, statt in einer undurchsichtigen Binärdatei zu verschwinden.
Das eignet sich besonders für:
- technische Dokumentation,
- Handbücher und Standards,
- README-Dateien,
- Entscheidungsprotokolle,
- Wissensbasen,
- Inhalte, die in mehreren Formaten erscheinen.
Links sind Teil der Wissensarchitektur
Ein Link sollte eine tatsächliche Beziehung erklären. In einer Dokumentation kann ein Fachbegriff auf eine ausführliche Erklärung verweisen, eine Betriebsanleitung auf das passende Runbook und eine Quellenangabe auf die ursprüngliche Spezifikation.
Zu viele Links erschweren das Lesen. Derselbe Begriff muss auf einer Seite nicht bei jeder Wiederholung erneut verlinkt werden. Entscheidend ist der erste hilfreiche Übergang, nicht die Anzahl der Verweise.
Grenzen und Risiken
Markdown ist kein Berechtigungssystem und kein Schutz für vertrauliche Inhalte. Ob ein Dokument öffentlich, intern oder geheim ist, entscheidet seine Ablage und Zugriffskontrolle.
Einige Renderer erlauben eingebettetes HTML. Das erweitert die Darstellung, kann aber Portabilität und Sicherheit verschlechtern. Bei Inhalten aus unbekannter Quelle muss der Renderer gefährliche HTML-Elemente und Links filtern. Für langlebige Dokumentation ist der gemeinsam unterstützte Markdown-Kern oft die stabilere Wahl.
Merksatz
Markdown hält Inhalte lesbar und portabel. Einheitlich wird es erst durch einen festgelegten Dialekt, einen kontrollierten Renderer und eine klare Linkstruktur.