Markdown ist eine einfache Auszeichnungssprache, mit der du Text schnell und ablenkungsfrei formatierst. Statt mit der Maus durch Menüs zu klicken, schreibst du ein paar Sonderzeichen direkt in den Fließtext – und aus **fett** wird beim Rendern fett. Markdown wurde 2004 von John Gruber entwickelt mit dem Ziel, dass der Quelltext schon im Rohzustand gut lesbar bleibt. Heute ist es der De-facto-Standard für Dokumentation, Notizen und Foren. Dieser Artikel zeigt dir die Syntax und warum sie sich lohnt.
Warum Markdown statt Word oder HTML?
Ein klassisches Textverarbeitungsprogramm mischt Inhalt und Formatierung in einem proprietären Binärformat. Markdown trennt beides sauber: Du schreibst reinen Text mit minimalen Auszeichnungen. Das hat handfeste Vorteile. Markdown-Dateien sind winzig, lassen sich mit jedem Editor öffnen, funktionieren bestens mit Versionskontrolle wie Git und altern nicht – auch in zehn Jahren wirst du eine .md-Datei noch problemlos lesen.
Gegenüber rohem HTML ist Markdown deutlich schneller zu schreiben und im Rohzustand lesbar. Für eine Überschrift tippst du # Titel statt <h1>Titel</h1>. Bei Bedarf lässt sich HTML aber jederzeit direkt einbetten, wenn Markdown an seine Grenzen stößt.
Die grundlegende Syntax
Überschriften und Hervorhebungen
# Überschriftbis###### Überschrift– sechs Ebenen, je nach Anzahl der Rauten.**fett**oder__fett__für fetten Text.*kursiv*oder_kursiv_für kursiven Text.~~durchgestrichen~~für durchgestrichenen Text.
Listen, Links und Bilder
- Ungeordnete Listen beginnst du mit
-,*oder+. - Geordnete Listen schreibst du mit
1.,2.und so weiter. - Ein Link entsteht mit
[Linktext](https://example.com). - Ein Bild funktioniert genauso, nur mit vorangestelltem Ausrufezeichen:
.
Diese Zeichen einzeln im Kopf zu behalten ist anfangs ungewohnt. Am leichtesten lernst du Markdown, wenn du sofort siehst, was deine Eingabe bewirkt. Mit der Markdown Preview schreibst du links dein Markdown und siehst rechts in Echtzeit das gerenderte HTML – inklusive Toolbar für Fett, Kursiv, Tabellen und Code-Blöcke.
Code-Blöcke und Tabellen
Gerade für technische Dokumentation glänzt Markdown. Inline-Code setzt du in einfache Backticks: `npm install`. Für ganze Code-Blöcke nutzt du drei Backticks vor und nach dem Block – optional mit Sprachangabe für Syntax-Highlighting. Tabellen baust du mit senkrechten Strichen und Bindestrichen für die Trennzeile:
- Die erste Zeile enthält die Spaltenüberschriften.
- Die zweite Zeile aus Bindestrichen trennt Kopf und Inhalt.
- Mit Doppelpunkten in der Trennzeile steuerst du die Ausrichtung der Spalten.
Wo Markdown überall steckt
Wenn du programmierst oder im Web aktiv bist, begegnet dir Markdown ständig. Die README.md-Datei in jedem GitHub-Repository ist Markdown. Issues, Pull Requests und Kommentare auf GitHub und GitLab nutzen es. Statische Website-Generatoren wie Jekyll, Hugo oder Astro erzeugen ganze Blogs aus Markdown-Dateien. Notiz-Apps wie Obsidian, Notion oder Bear setzen darauf, ebenso Chat-Tools wie Discord oder Slack mit einer reduzierten Variante.
Diese enorme Verbreitung macht Markdown zu einer Fähigkeit, die sich überall auszahlt. Einmal gelernt, schreibst du formatierte Texte schneller als in jedem Editor mit Maus.
Von Markdown zu HTML und zurück
Markdown wird letztlich immer in HTML umgewandelt, bevor es im Browser erscheint. Diese Konvertierung übernimmt ein Parser. Wenn du den fertigen HTML-Code brauchst – etwa um ihn in ein CMS einzufügen, das kein Markdown versteht – kannst du ihn direkt exportieren. Die Markdown Preview bietet dafür einen HTML-Export an. Für den umgekehrten Weg oder einfache Einzelfälle hilft auch der Markdown zu HTML Konverter.
Tipps für sauberes Markdown
- Lass eine Leerzeile zwischen Absätzen – ein einfacher Zeilenumbruch reicht oft nicht.
- Bleib bei einem Stil, etwa durchgängig
-für Listen, um konsistent zu bleiben. - Verschachtle Listen mit Einrückung um zwei oder vier Leerzeichen.
- Nutze aussagekräftige Alt-Texte bei Bildern – gut für Barrierefreiheit und SEO.
Häufige Fragen
Gibt es nur eine Markdown-Variante?
Nein. Neben dem ursprünglichen Markdown gibt es Erweiterungen wie GitHub Flavored Markdown (GFM) mit Tabellen, Aufgabenlisten und Durchstreichen oder CommonMark als Standardisierungsversuch. Die Grundlagen sind überall gleich, einzelne Features unterscheiden sich.
Kann ich in Markdown HTML verwenden?
Ja, die meisten Parser erlauben eingebettetes HTML. Das ist nützlich für Dinge, die Markdown nicht abdeckt, etwa komplexe Tabellen oder besondere Formatierungen.
Wie lerne ich Markdown am schnellsten?
Durch Ausprobieren. Schreib einen kurzen Text mit Überschriften, Listen und einem Link in einer Live-Vorschau und beobachte, wie sich die Eingabe auswirkt. Nach wenigen Minuten sitzen die wichtigsten Zeichen.