Was Markdown ist, woher es kommt und wozu es gut ist
Kurz gesagt: Markdown ist eine Art, formatierten Text in einer reinen Textdatei zu schreiben — mit Zeichen, die ein Mensch auch ohne Programm lesen kann. Eine Zeile, die mit # beginnt, ist eine Überschrift, **so etwas** ist fett, eine Zeile, die mit - beginnt, ist ein Listenpunkt. Ein Konverter macht daraus HTML; ein Mensch liest es so oder so. Dieses Doppelleben — lesbar als Text, setzbar als Dokument — ist die ganze Idee und der Grund, warum Markdown jedes schickere Format überlebt hat, das kam, um es zu ersetzen.
Woher es kommt
Markdown erschien im März 2004, veröffentlicht von John Gruber, der es zusammen mit Aaron Swartz schrieb. Die Implementierung war ein Perl-Skript von rund 1 400 Zeilen namens Markdown.pl, und das Ziel war ohne Umschweife ausgesprochen: wer fürs Web schrieb, hatte es satt, HTML-Tags von Hand zu tippen — und die E-Mail hatte längst allen beigebracht, wie man Text beiläufig auszeichnet.
Der zweite Teil ist der wichtige, denn Markdown hat seine Zeichen nicht erfunden. Es hat sie aus den Gewohnheiten gesammelt, die in reinen Text-E-Mails ohnehin schon üblich waren:
- Sternchen um ein Wort für Betonung, wie es Usenet und E-Mail zwanzig Jahre lang taten
- eine zitierte Antwort, deren Zeilen mit
>beginnen, wie es jedes Mailprogramm machte - eine Überschrift, mit
===oder---unterstrichen, aus Setext, einem Format von Ian Feldman aus dem Jahr 1992 - die Raute
#vor einer Überschrift, aus atx, das Aaron Swartz 2002 schrieb
Grubers Beitrag war die Auswahl und die Regel dahinter: ein Markdown-Dokument soll sich wie ein normales Textdokument lesen, nicht wie ein Dokument voller Tags. Nichts in der Syntax soll für jemanden, der nichts von Markdown weiß, nach Auszeichnung aussehen.
Der Name ist ein Scherz auf Kosten von markup, also der Auszeichnung, und die ursprüngliche Lizenz war freizügig genug, dass jeder Markdown neu umsetzen konnte — was dann auch alle taten.
Warum es sich durchsetzte
Markdown kam ohne Gremium, ohne Firma und ohne Norm und landete trotzdem überall. Drei Eigenschaften haben das erledigt.
Es ist reiner Text, also arbeitet jedes Werkzeug schon damit. Die Versionsverwaltung vergleicht es Zeile für Zeile und zeigt dir, was sich in einem Absatz geändert hat — versuch das mit einer Datei aus der Textverarbeitung. Die Suche findet es. Ein Skript kann es erzeugen. Es übersteht den Weg durch eine E-Mail, in einen Chat und wieder heraus. In vierzig Jahren wird es sich noch öffnen lassen.
Es zu lernen kostet etwa fünf Minuten. Mit drei Zeichen bist du produktiv, den Rest entdeckst du, wenn du ihn brauchst. Nichts versteckt sich hinter einer Werkzeugleiste.
Es bleibt auch ohne Renderer lesbar. Wer kein Programm zum Darstellen hat, sieht Sternchen und Rauten, liest den Text aber noch in der richtigen Reihenfolge, mit sichtbarer Struktur. Für kein Binärformat gilt das.
Die Plattformen, die es früh übernahmen, machten es zur Selbstverständlichkeit. Stack Overflow startete 2008 mit einem Markdown-Editor. GitHub stellte README.md auf den Projektseiten dar, und von dort wurde „schreib deine README in Markdown“ zur Konvention einer ganzen Branche. Jekyll, im selben Jahr veröffentlicht, machte aus Ordnern voller Markdown-Dateien Websites, und GitHub Pages lieferte sie kostenlos aus.
Bis 2016 war das Format verbreitet genug, um in RFC 7763 bei der IANA als Medientyp text/markdown registriert zu werden.
Die Dialekte und warum es mehrere gibt
Grubers ursprüngliche Beschreibung ließ Fälle offen — was passiert, wenn eine Liste unterbrochen wird, wie sich Betonung innerhalb eines Wortes verschachtelt, was eine verirrte Klammer bedeutet. Jede Implementierung entschied das anders, also sah dieselbe Datei in verschiedenen Werkzeugen verschieden aus.
2014 schrieb eine Gruppe um John MacFarlane, den Autor von Pandoc, eine präzise Spezifikation samt Testsuite. Sie erschien als „Standard Markdown“, Gruber hatte etwas gegen den Namen, und sie wurde in CommonMark umbenannt. Dieser Spezifikation folgen heute die meisten Renderer.
| Dialekt | Was er hinzufügt | Wo du ihm begegnest |
|---|---|---|
| CommonMark | Die präzise Grundlage: eindeutige Regeln und eine Testsuite | Die meisten Bibliotheken und Editoren |
| GitHub Flavored Markdown | Tabellen, Aufgabenlisten, Durchstreichungen, Autolinks, Fußnoten, Hinweisblöcke | GitHub, GitLab, die meisten README-Dateien |
| MultiMarkdown | Zitate, Querverweise, Metadaten, bessere Tabellen | Wissenschaftliche und lange Texte |
| Pandoc Markdown | Alles davon plus Mathematik, Abbildungen und Ausgabe als PDF, Word, LaTeX | Aufsätze, Bücher, Abschlussarbeiten |
| MDX | In JSX geschriebene Komponenten, eingebettet in den Text | Dokumentationsseiten auf React |
GFM ist das, was die meisten heute meinen, wenn sie Markdown sagen: CommonMark plus die Erweiterungen, die GitHub 2017 festgelegt hat. PreviewMD rendert GFM, Mathematik über KaTeX und Diagramme über Mermaid.
Wofür man es benutzt
Dokumentation und READMEs. Die Voreinstellung für alles, was ein Entwickler liest: Projekt-Readmes, Changelogs, Architekturnotizen, Runbooks. Dokumentationsseiten — MkDocs, Docusaurus, Hugo, Astro — sind meist Ordner voller Markdown mit einem Thema darüber.
Notizen. Obsidian, Bear, iA Writer, Logseq und ein Dutzend andere legen Notizen als Markdown-Dateien ab, und damit sitzen deine Notizen nicht in der Falle: du kannst sie mit jedem Editor lesen, mit jedem Werkzeug sichern und in eine andere App umziehen, ohne vorher zu exportieren.
Schreiben fürs Web. Statische Seiten, Newsletter und Blogs, bei denen der Autor Prosa schreiben will und keine Auszeichnung. Der Text, den du gerade liest, ist eine Markdown-Datei; der Umschalter oben auf dieser Seite zeigt sie.
Überall, wo ein Textfeld Formatierung annimmt. Issue-Tracker, Pull Requests, Chat-Apps, Foren und Wikis benutzen Markdown oder einen nahen Verwandten.
Reden mit Maschinen. Sprachmodelle geben von sich aus Markdown aus, was es stillschweigend zur Verkehrssprache zwischen Menschen und KI-Werkzeugen gemacht hat — die Überschriften, Listen und Codeblöcke in der Antwort eines Assistenten sind gerendertes Markdown.
Worin es schwach ist
Markdown ist ein Format für Struktur, nicht für Layout. Es kann nicht sagen, wo etwas auf einer Seite sitzt, wie breit eine Spalte ist oder welche Schrift gelten soll — und das ist Absicht, denn diese Entscheidungen gehören dem, was das Dokument darstellt.
Es passt also schlecht, wenn die Form der Seite der Punkt ist: ein Flyer, ein Formular, eine Magazindoppelseite. Komplexe Tabellen mit verbundenen Zellen sind unbequem und enden meist als HTML. Und für wissenschaftliches Schreiben mit Zitaten und Querverweisen reicht reines Markdown allein nicht — dafür gibt es die Erweiterungen von Pandoc und MultiMarkdown.
Der verbreitete Ärger — „meine Datei sieht in einer anderen App anders aus“ — geht fast immer auf einen Dialektunterschied zurück. Für CommonMark plus GFM zu schreiben ist die sicherste Wahl, weil sich darauf die meisten Werkzeuge einig sind.
Markdown auf dem Mac
macOS stellt .md von Haus aus nicht dar: die Leertaste zeigt reinen Text, und ein Ordner voller Notizen sieht aus wie ein Stapel gleicher leerer Symbole.
PreviewMD behebt genau diesen Teil — Quick-Look-Vorschauen, Dokumentminiaturen und ein Fenster mit der gerenderten Seite neben ihrem Quelltext. Es rendert GitHub Flavored Markdown, Mathematik mit KaTeX und Diagramme mit Mermaid sind mitgeliefert, sodass beim Rendern eines Dokuments nichts nachgeladen wird.
Der Spickzettel führt jedes Zeichen mit dem auf, was es erzeugt, und wie man auf einem Mac eine .md-Datei öffnet deckt die praktische Seite ab.