Markdown Anleitung: Erste Schritte

Markdown ist eine Formatierungssyntax für Klartext, die getippte Zeichen in strukturierte Dokumente verwandelt, und der Kern lässt sich in etwa 10 Minuten lernen. John Gruber veröffentlichte Markdown im März 2004 unter Mitwirkung von Aaron Swartz, und 22 Jahre später formatiert es README-Dateien auf GitHub, Notizen in Obsidian und Beiträge auf Reddit. Das ganze System besteht aus zwei Teilen: einer Textdatei mit der Endung .md und einem Prozessor, der diesen Text in HTML umwandelt. Alles Weitere baut auf diesen zwei Teilen auf.

Was ist Markdown?

Markdown ist eine leichtgewichtige Auszeichnungssprache aus dem Jahr 2004, die Klartext über sichtbare Zeichen wie #, * und > mit Formatierungsanweisungen versieht. Ein # am Zeilenanfang erzeugt eine Überschrift. Zwei Sternchen um ein Wort machen es fett. Ein Bindestrich beginnt einen Aufzählungspunkt. Die ursprüngliche Version war ein einzelnes Perl-Skript, Markdown.pl, veröffentlicht auf Grubers Website Daring Fireball.

Schwerere Auszeichnungssprachen, darunter HTML und LaTeX, packen Inhalte in Tags und Befehle, die die Rohdatei unübersichtlich machen. Markdown ging den entgegengesetzten Weg. Gruber entwarf die Syntax mit einem Ziel: Eine Markdown-Datei soll sich schon vor jeder Umwandlung sauber als Klartext lesen lassen. Die Zeile ## Pricing ist offensichtlich eine Überschrift, selbst für jemanden, der noch nie von Markdown gehört hat. Diese Lesbarkeit ist der Grund, warum sich das Format von Blogs im Jahr 2004 über GitHub 2008 und Stack Overflow 2010 bis zu Notiz-Apps wie Obsidian und Joplin in den 2010er Jahren verbreitete.

Wie sich Markdown von WYSIWYG-Editoren unterscheidet

Ein WYSIWYG-Editor wie Microsoft Word oder Google Docs wendet Formatierungen über Schaltflächen an und verbirgt die Anweisungen; Markdown hält jede Anweisung als Zeichen in der Datei sichtbar. WYSIWYG steht für "what you see is what you get". In Word markieren Sie eine Passage und klicken auf die Schaltfläche Fett, und die Datei speichert diese Entscheidung in binärem XML, das Sie nie zu sehen bekommen. In Markdown tippen Sie **launch date**, und die beiden Sternchenpaare sind die Formatierung.

Der Unterschied zeigt sich beim Speichern. Eine .docx-Datei öffnet sich korrekt nur in einer kurzen Liste von Programmen, allen voran Word, LibreOffice und Pages. Eine Markdown-Datei öffnet sich in jedem Texteditor seit den 1970er Jahren, von Notepad über vim bis VS Code. Viele Markdown-Editoren schließen die visuelle Lücke mit einer geteilten Live-Vorschau: rohe Syntax im linken Bereich, gerenderte Ausgabe im rechten Bereich, aktualisiert bei jedem Tastendruck. Sie bekommen das direkte Feedback von Word mit der Transparenz von Klartext.

Warum Markdown verwendet wird

Autoren wählen Markdown aus vier praktischen Gründen: Portabilität, Plattformunabhängigkeit, Zukunftssicherheit und Reichweite. Jeder davon geht auf die Klartext-Basis zurück.

• Portabilität. Eine Markdown-Datei wandert ohne Konvertierung zwischen Anwendungen. Entwerfen Sie einen Beitrag in iA Writer, bearbeiten Sie ihn in VS Code, veröffentlichen Sie ihn über Ghost. Die Datei ändert nie ihre Form. Proprietäre Formate wie .docx und .pages sperren Inhalte in das Ökosystem eines einzelnen Anbieters.
• Plattformunabhängigkeit. Markdown funktioniert identisch unter Windows 11, macOS, Linux, iOS und Android. Die Datei ist UTF-8-Text, sodass eine 2026 auf dem Smartphone getippte Notiz Byte für Byte identisch auf dem Desktop erscheint.
• Zukunftssicherheit. Software stirbt; Textdateien überleben. WordPerfect dominierte die Textverarbeitung im Jahr 1990, und seine alten Dateien sind heute ein Fall für die Datenrettung. Eine Markdown-Datei aus dem Jahr 2004 öffnet sich weiterhin in unter einer Sekunde, was für Abschlussarbeiten, Verträge und Buchmanuskripte mit einem Horizont von 20 Jahren zählt.
• Reichweite. Plattformen wie GitHub, GitLab, Reddit, Discord, Notion und Slack akzeptieren Markdown-Eingaben. Lernen Sie die Syntax einmal, und sie zahlt sich überall aus.

Wie die Markdown-Verarbeitung funktioniert

Markdown wird über eine Pipeline mit 4 Schritten zum formatierten Dokument: Sie schreiben eine .md-Datei, ein Prozessor parst sie, der Prozessor gibt HTML aus, und ein Browser rendert dieses HTML. Der Prozessor, auch Parser oder Implementierung genannt, ist der Motor in jeder Markdown-Anwendung. Zu den verbreiteten Prozessoren gehören markdown-it, marked, cmark und Pandoc, und cmark wandelt ein typisches Dokument in unter 10 Millisekunden um.

Verschiedene Tools zeigen unterschiedlich viel von dieser Pipeline. Ein Online-Editor mit Live-Vorschau führt die Schritte 2 bis 4 bei jedem Tastendruck unsichtbar aus. Ein statischer Site-Generator wie Hugo lässt dieselbe Pipeline mit einem einzigen Build-Befehl über Hunderte von Dateien laufen. Die Pipeline selbst ändert sich nie, und die HTML-Ausgabe lässt sich mit jedem CSS-Stylesheet kombinieren oder über ein Tool wie Pandoc weiter in PDF, EPUB oder .docx umwandeln.

Wofür wird Markdown verwendet?

Markdown erledigt sieben typische Aufgaben: Websites, Notizen, Dokumente, Bücher, Präsentationen, E-Mail und technische Dokumentation. Dieselbe in 10 Minuten erlernte Syntax deckt alle sieben ab.

Websites

Statische Site-Generatoren wie Hugo, Jekyll und Eleventy bauen komplette Websites aus Ordnern voller Markdown-Dateien. Jekyll, erschienen 2008, treibt GitHub Pages samt kostenlosem Hosting an. Auch Content-Plattformen nehmen Markdown an: Ghost hat einen nativen Markdown-Editor, und WordPress akzeptiert Markdown über seinen Block-Editor. Ein Blogbeitrag ist eine einzelne .md-Datei, und Versionskontrollsysteme wie Git verfolgen jede Änderung daran.

Notizen und Dokumente

Notiz-Apps wie Obsidian, Joplin, Bear und Simplenote speichern jede Notiz als Markdown. Allein Obsidian legt jeden Vault als Ordner mit .md-Dateien auf Ihrer eigenen Festplatte ab, sodass eine Sammlung von 5.000 Notizen mit Standardwerkzeugen durchsuchbar bleibt. Für einzelne Dokumente, Briefe, Sitzungsprotokolle und Hausarbeiten exportiert ein Markdown-Editor direkt nach PDF oder HTML, und das PDF lässt sich drucken, an E-Mails anhängen oder überall hochladen.

Bücher und Präsentationen

Leanpub verwandelt einen Ordner mit Markdown-Dateien in ein fertiges E-Book in den Formaten PDF und EPUB, und Pandoc leistet dasselbe auf der Kommandozeile. Autoren haben auf diesem Weg komplette Romane und technische Bücher mit 300 Seiten veröffentlicht. Für Folien wandeln Tools wie Marp und Remark eine Markdown-Datei in ein Präsentationsdeck um, mit einem ----Trenner pro Folie, was sich schneller überarbeiten lässt als eine PowerPoint-Datei mit 40 von Hand formatierten Folien.

E-Mail und technische Dokumentation

Browser-Erweiterungen wie Markdown Here wandeln Markdown in formatierte HTML-E-Mails in Gmail und anderen Webmail-Diensten um. Dokumentation ist das Heimspiel von Markdown: GitHub rendert die README.md ganz oben in jedem Repository, und Generatoren wie MkDocs, Docusaurus und Read the Docs bauen komplette Dokumentationssites aus .md-Quelldateien. Docusaurus, 2017 von Meta veröffentlicht, ergänzt schlichte Markdown-Seiten um Versionierung und Suche.

Markdown-Flavors: CommonMark und GFM

Ein Markdown-Flavor ist eine bestimmte Variante der Syntax, und die zwei wichtigsten sind CommonMark, spezifiziert 2014, und GitHub Flavored Markdown, spezifiziert 2017. Grubers Version von 2004 ließ Randfälle offen, etwa wie verschachtelte Listen einzurücken sind, weshalb frühe Prozessoren bei der Ausgabe voneinander abwichen. Dieselbe Datei wurde in verschiedenen Tools unterschiedlich dargestellt.

CommonMark hat das behoben. Die im September 2014 von einer Arbeitsgruppe um John MacFarlane und Jeff Atwood veröffentlichte CommonMark-Spezifikation legt jede Parsing-Regel in mehr als 600 Testfällen fest. Stack Overflow stellte sein Rendering im Juni 2020 auf CommonMark um.

GitHub Flavored Markdown, kurz GFM, ist eine strikte Obermenge von CommonMark, die GitHub im März 2017 formalisiert hat. Sie ergänzt fünf Erweiterungen: Tabellen, Aufgabenlisten, Durchstreichungen, automatische Links und eingezäunte Codeblöcke mit Sprachangabe. Wenn eine Produktseite angibt, sie "unterstützt Markdown", prüfen Sie, welcher Flavor gemeint ist, denn eine GFM-Tabelle erscheint in einem reinen CommonMark-Tool nur als nackte senkrechte Striche. GFM ist 2026 der sicherste Standard, und es ist der Flavor, den der Editor dieser Website rendert.

So starten Sie noch heute mit Markdown

Öffnen Sie einen browserbasierten Markdown-Editor, tippen Sie ein # gefolgt von einem Titel, und Sie haben Ihr erstes Markdown geschrieben; es gibt nichts zu installieren und kein Konto anzulegen. Ein Editor mit geteilter Ansicht zeigt das gerenderte Ergebnis, während Sie tippen, was die schnellste Feedbackschleife zum Markdown lernen ist.

Beginnen Sie mit den fünf häufigsten Elementen: # für Überschriften, **bold** für Fettdruck, *italic* für Kursivschrift, - für Listen und [text](url) für Links. Diese fünf decken rund 90 % der alltäglichen Formatierung ab. Üben Sie, indem Sie etwas Reales umschreiben, eine Besprechungsnotiz oder eine To-do-Liste, und speichern Sie das Ergebnis als .md-Datei. Von dort aus behandelt die Anleitung zur Basissyntax alle 9 Kernelemente, und die Anleitung zur erweiterten Syntax ergänzt GFM-Tabellen, Fußnoten und Aufgabenlisten.

Häufig gestellte Fragen

Muss ich Software installieren, um Markdown zu schreiben?

Ein Webbrowser genügt; ein Online-Markdown-Editor übernimmt Schreiben, Vorschau und Export ganz ohne Installation. Desktop-Anwendungen wie Obsidian, iA Writer und VS Code bieten Offline-Zugriff und lokale Dateiverwaltung, sobald Sie das möchten.

Welche Dateiendung hat eine Markdown-Datei?

Markdown-Dateien verwenden die Endung .md, mit .markdown als selteneren Alternative. Beide enthalten identischen Klartext, und jeder Markdown-Prozessor, von cmark bis Pandoc, akzeptiert beide.

Wie lange dauert es, Markdown zu lernen?

Die fünf Kernelemente lernen Sie in etwa 10 Minuten, und die vollständige Basissyntax mit 9 Elementen passt in eine einzige Sitzung. GFM-Erweiterungen wie Tabellen und Aufgabenlisten kosten weitere 15 Minuten. Vergleichen Sie das mit LaTeX, wo solide Formatierung Wochen erfordert.

Was ist der Unterschied zwischen CommonMark und GFM?

CommonMark ist die Basisspezifikation von 2014, die das Parsen des Markdown-Kerns standardisiert, und GFM ist GitHubs Obermenge von 2017, die Tabellen, Aufgabenlisten, Durchstreichungen, automatische Links und eingezäunte Codeblöcke ergänzt. Jedes gültige CommonMark-Dokument ist zugleich gültiges GFM, daher ist Schreiben in GFM die praktische Wahl.