Was ist Markdown? Einfache Erklärung mit Beispielen

Wer schon einmal eine README-Datei auf GitHub gesehen oder in einem Forum mit Sternchen Text fett gemacht hat, ist Markdown bereits begegnet, vielleicht ohne es zu wissen. Markdown wurde 2004 von John Gruber entwickelt, mit einem klaren Ziel: Text so zu formatieren, dass die Auszeichnung auch im Rohzustand gut lesbar bleibt. Genau das macht Markdown bis heute so beliebt.

Der Name selbst ist ein kleines Wortspiel. Klassische Auszeichnungssprachen wie HTML heißen auf Englisch Markup. Gruber wollte etwas Leichteres, das nicht aufträgt, und nannte es deshalb scherzhaft Markdown. Das beschreibt die Idee gut: Statt jede Formatierung mit umständlichen Klammern und Tags auszuzeichnen, genügen ein paar dezente Zeichen, die man ohnehin auf jeder Tastatur findet. Wer Markdown liest, sieht keinen Wust aus spitzen Klammern, sondern fast normalen Text mit ein wenig Würze. Genau dieser Ansatz hat dafür gesorgt, dass Markdown vom Nischenwerkzeug für Blogger zum Quasi-Standard für technische Texte geworden ist.

Die Definition in einem Satz

Markdown ist eine einfache Auszeichnungssprache, die formatierten Text mit gut lesbaren Sonderzeichen beschreibt und sich in HTML umwandeln lässt. Der Begriff Auszeichnungssprache bedeutet, dass man Textstellen mit Markierungen versieht, etwa um sie als Überschrift oder als Liste zu kennzeichnen. Das Besondere an Markdown ist, dass diese Markierungen unaufdringlich bleiben. Ein mit Sternchen umschlossenes Wort liest sich auch ohne Darstellung noch flüssig.

Wichtig zu verstehen: Markdown ist kein Ersatz für ein Textverarbeitungsprogramm und auch keine eigene Datei-Welt. Es ist schlicht eine Vereinbarung, wie man bestimmte Zeichen deutet. Eine Markdown-Datei ist deshalb immer auch eine ganz normale Textdatei, die jeder Editor öffnen kann. Erst ein Programm, das die Vereinbarung kennt, macht aus den Zeichen sichtbare Formatierung. Das hat einen großen Vorteil: Ihre Inhalte bleiben für immer lesbar, selbst wenn das Programm, mit dem Sie sie geschrieben haben, längst nicht mehr existiert.

Wofür wird Markdown genutzt?

Markdown hat sich überall dort durchgesetzt, wo Text einfach, portabel und versionierbar bleiben soll. Die häufigsten Einsatzgebiete sind:

• README-Dateien: Fast jedes Software-Projekt auf GitHub oder GitLab beschreibt sich in einer README.md. Eine Anleitung gibt der Ratgeber README mit Markdown erstellen.
• Technische Dokumentation: Statische Doku-Generatoren und Wikis nutzen Markdown als Quellformat.
• Foren und Chats: Plattformen wie Reddit, Discord oder Stack Overflow erlauben Formatierung über Markdown.
• Notizen: Viele Notiz-Apps speichern Inhalte als Markdown, weil sich der Text so jederzeit weiterverwenden lässt.
• KI-Prompts: Sprachmodelle verarbeiten klar strukturierten Markdown-Text besonders gut, etwa mit Überschriften und Listen.

Allen diesen Einsatzgebieten ist eines gemeinsam: Der Inhalt soll auch in fünf oder zehn Jahren noch zugänglich sein und sich leicht von einem System ins nächste bewegen lassen. Weil Markdown reiner Text ist, lässt es sich problemlos mit Versionsverwaltungen wie Git nachverfolgen. Jede Änderung wird sichtbar, Zeile für Zeile, was bei einem undurchsichtigen Binärformat unmöglich wäre. Genau das schätzen Entwicklerinnen und Entwickler, aber zunehmend auch Redaktionen und Wissensarbeiter, die ihre Texte sauber dokumentiert halten möchten.

Markdown, HTML und Rich Text im Vergleich

Markdown steht zwischen zwei Welten: dem mächtigen, aber umständlichen HTML und dem komfortablen, aber unsichtbaren Rich Text aus klassischen Textverarbeitungen. Die Tabelle ordnet die drei ein.

Den ausführlichen Vergleich lesen Sie im Ratgeber Markdown vs. HTML.

Die wichtigste Syntax mit Mini-Beispielen

Das Schöne an Markdown ist, dass man die Grundlagen in wenigen Minuten beherrscht. Hier die wichtigsten Elemente auf einen Blick:

# Überschrift Ebene 1
## Überschrift Ebene 2

Ein Absatz mit **fettem** und *kursivem* Text.

- Listenpunkt eins
- Listenpunkt zwei

[Ein Link](https://example.com)

Für Code mitten im Satz nutzt man einfache Backticks:

Das ist `Inline-Code` mitten im Satz.

Eine vollständige Übersicht aller Befehle finden Sie im Markdown-Spickzettel sowie in der Markdown-Syntax-Übersicht.

Wer diese wenigen Bausteine kennt, deckt damit schon den Großteil aller alltäglichen Texte ab. Eine Raute für Überschriften, Sternchen für Hervorhebungen, Bindestriche für Listen und eckige Klammern für Links: Mehr braucht man für einen sauber gegliederten Beitrag oft gar nicht. Darüber hinaus gibt es Erweiterungen für Tabellen, Bilder, Zitate und Code, die genauso leicht zu lernen sind. Das Schöne ist, dass Sie nichts auswendig können müssen. Sie schreiben einfach los, und sobald Sie ein Element brauchen, schlagen Sie die passende Schreibweise kurz nach. Nach wenigen Texten sitzt das Wichtigste von selbst.

GitHub Flavored Markdown und CommonMark

Markdown war in den ersten Jahren nicht streng definiert, weshalb verschiedene Programme es leicht unterschiedlich auslegten. Daraus entstand CommonMark, eine genaue Spezifikation, die festlegt, wie der Kern von Markdown eindeutig zu verstehen ist. CommonMark ist heute die Grundlage der meisten Werkzeuge.

Darauf baut GitHub Flavored Markdown auf, kurz GFM. Es ergänzt den Kern um praktische Erweiterungen wie Tabellen, durchgestrichenen Text, Task-Listen und das automatische Erkennen von Webadressen. Wenn Sie heute Markdown schreiben, ist es meist CommonMark mit GFM-Erweiterungen. Die Details erklärt der Ratgeber GitHub Flavored Markdown.

Für den Alltag bedeutet das: Sie müssen sich um diese Feinheiten selten Gedanken machen. Die gängigen Plattformen und Editoren verstehen die verbreiteten Erweiterungen, und für reinen Fließtext mit Überschriften, Listen und Links ist ohnehin alles gleich. Erst wenn Sie eine Tabelle, eine Task-Liste oder eine andere Erweiterung nutzen und das Ergebnis unerwartet aussieht, lohnt sich der Blick auf den Dialekt des Zielsystems. Im Zweifel hilft Ausprobieren: Sie sehen sofort, ob die gewünschte Formatierung übernommen wird.

Womit schreibt und betrachtet man Markdown?

Weil Markdown reiner Text ist, genügt im Prinzip jeder Texteditor. Komfortabler wird es mit Werkzeugen, die das Ergebnis sofort darstellen: spezielle Markdown-Editoren mit Live-Vorschau, Notiz-Apps oder Code-Editoren mit entsprechender Unterstützung. Wer eine Markdown-Datei vor sich hat und sie ansehen möchte, findet im Ratgeber Markdown-Datei öffnen die passenden Wege.

Am schnellsten geht es direkt im Browser: Auf html-md.de fügen Sie Markdown ein und sehen das Ergebnis sofort als HTML und in der Vorschau. So lässt sich Markdown ausprobieren, ohne irgendetwas zu installieren.

Wer den umgekehrten Weg gehen möchte, also bestehendes HTML in Markdown verwandeln, findet dafür ebenfalls ein passendes Werkzeug. Beide Richtungen ergänzen sich im Alltag: Markdown zum Schreiben, HTML zum Anzeigen im Browser, und bei Bedarf wieder zurück, wenn ein Inhalt in ein Markdown-System wandern soll. Diese Beweglichkeit ist ein Hauptgrund, warum Markdown sich so hartnäckig hält. Es bindet Sie an kein einzelnes Programm und an keinen Hersteller. Ihr Text gehört Ihnen, bleibt lesbar und lässt sich jederzeit in das Format überführen, das gerade gebraucht wird.

Zusammengefasst ist Markdown also weit mehr als ein Trick für Programmierer. Es ist eine einfache, robuste Art, Texte zu strukturieren, die mit minimalem Aufwand erlernt und überall eingesetzt werden kann. Vom ersten Notizzettel bis zur umfangreichen Dokumentation eines Software-Projekts begleitet es Sie mit denselben wenigen Regeln. Wer einmal damit gearbeitet hat, möchte die Leichtigkeit selten wieder missen.

Häufige Fragen