Markdown: Syntax, Editoren und Anleitung für Einsteiger

Was ist Markdown?

Markdown ist eine Auszeichnungssprache für Klartext. Du schreibst normalen Text und markierst Struktur mit einfachen Zeichen: # für Überschriften, - für Listen, ** für fett. Ein Programm namens Parser übersetzt das anschließend in HTML – also in das Format, das Browser darstellen können.

Der Unterschied zu Word oder einem Editor im Content-Management-System: Du siehst beim Schreiben keine Formatierung, sondern deren Auslöser. Das klingt umständlich, ist in der Praxis aber schneller, weil deine Hände die Tastatur nicht verlassen. Und es gibt kein verstecktes Formatierungs-Durcheinander, das beim Einfügen in ein anderes System plötzlich sichtbar wird.

Markdown-Dateien tragen die Endung .md oder .markdown und sind reine Textdateien in UTF-8.

Wie Markdown entstanden ist

John Gruber veröffentlichte Markdown am 9. März 2004, mit fachlicher Unterstützung von Aaron Swartz. Sein Ziel war ausdrücklich nicht, HTML zu ersetzen, sondern eine Schreibweise zu schaffen, die sich am gewachsenen Formatierungsstil von E-Mails orientiert – Sternchen für Betonung, Bindestriche für Listen. Die letzte offizielle Version der Ursprungsvariante ist 1.0.1 vom 17. Dezember 2004. Seither hat sich am Original nichts geändert. Weiterentwickelt wurde stattdessen drumherum.

Markdown, CommonMark und GitHub Flavored Markdown

Grubers Beschreibung ließ viele Details offen. Verschiedene Anbieter haben diese Lücken unterschiedlich gefüllt – deshalb sieht dieselbe Datei je nach Plattform anders aus. Diese Varianten solltest du kennen:

Praktische Regel: Wenn du wissen willst, was funktioniert, halte dich an CommonMark plus GFM. Damit bist du auf GitHub, GitLab, in Obsidian, in den meisten Website-Generatoren und in fast jedem Editor auf der sicheren Seite.

Warum Markdown gerade jetzt an Bedeutung gewinnt

Markdown war lange ein Format für Entwicklerinnen. Das hat sich verschoben, und zwar aus einem Grund: Sprachmodelle arbeiten damit.

• KI-Assistenten geben Markdown aus. ChatGPT, Claude, Gemini und Copilot liefern Überschriften, Listen und Tabellen als Markdown. Wer regelmäßig mit KI-Texten arbeitet, bekommt Markdown ins Haus geliefert, ob er will oder nicht – und spart sich viel Aufräumarbeit, wenn er das Format einfach behält.
• Sprachmodelle lesen Markdown gut. Klare Struktur ohne Navigationsgerüst, ohne Skripte, ohne Layout-Ballast. Deshalb setzt der Vorschlag llms.txt – im September 2024 von Jeremy Howard eingebracht – ebenfalls auf Markdown. Wichtig zur Einordnung: Das ist eine freiwillige Konvention, kein verabschiedeter Standard, und kein großer Anbieter hat bislang offiziell bestätigt, die Datei auszuwerten. Google hat erklärt, sie nicht zu nutzen.
• Werkzeuge bauen Markdown-Schnittstellen ein. Notion bietet inzwischen Endpunkte, um Seiten direkt als Markdown zu lesen und zu erzeugen. Obsidian speichert Notizen von Haus aus als lokale .md-Dateien.

Für dich heißt das schlicht: Zeit, die du heute in Markdown investierst, zahlt sich in mehr Umgebungen aus als noch vor zwei Jahren.

Markdown-Syntax auf einen Blick: der Spickzettel

Hier ist die vollständige Referenz. Alles, was mit GFM markiert ist, gehört nicht zum Original, funktioniert aber in den meisten aktuellen Umgebungen.

Überschriften

# Überschrift 1
## Überschrift 2
### Überschrift 3
#### Überschrift 4
##### Überschrift 5
###### Überschrift 6

Setz immer ein Leerzeichen nach der letzten Raute. Ohne Leerzeichen erkennen viele Parser die Überschrift nicht.

Textauszeichnung

Unterstreichen ist der häufigste Stolperstein: Markdown kennt dafür kein eigenes Zeichen, weil Unterstreichung im Web für Links reserviert ist. Wenn du sie brauchst, schreib das HTML-Element direkt hinein – das ist in Markdown ausdrücklich erlaubt.

Listen und Aufgabenlisten

- ungeordnete Liste
- zweiter Eintrag
  - Unterpunkt mit zwei Leerzeichen eingerückt

1. geordnete Liste
2. zweiter Eintrag

- [ ] offene Aufgabe (GFM)
- [x] erledigte Aufgabe (GFM)

Für ungeordnete Listen funktionieren -, * und + gleichwertig. Bleib innerhalb eines Dokuments bei einem Zeichen, dann bleibt die Datei lesbar.

Links und Bilder

[easyname](https://www.easyname.at)
[mit Titel](https://www.easyname.at "Domains und Webhosting")
<https://www.easyname.at>

![Alternativtext](bild.jpg)
![Alternativtext](bild.jpg "Bildtitel")

[Referenzlink][1]

[1]: https://www.easyname.at

Bilder sind Links mit einem Rufzeichen davor. Der Text in den eckigen Klammern wird zum Alternativtext – schreib dort etwas Beschreibendes hin, das hilft der Barrierefreiheit und der Auffindbarkeit.

Code und Codeblöcke

Für Code im laufenden Satz setzt du den Ausdruck zwischen zwei Backticks. Für ganze Blöcke verwendest du drei Backticks in einer eigenen Zeile, davor und danach:

```html
<p>Hallo Welt</p>
```

Die Sprachangabe direkt nach den drei Backticks aktiviert die farbige Hervorhebung. Alternativ funktionieren drei Tilden (~~~) – praktisch, wenn im Codeblock selbst Backticks vorkommen.

Tabellen (GFM)

| Spalte A | Spalte B | Spalte C |
|:---------|:--------:|---------:|
| links    | zentriert| rechts   |
| Zelle    | Zelle    | Zelle    |

Der Doppelpunkt in der Trennzeile steuert die Ausrichtung: links, beidseitig für zentriert, rechts. Die Striche müssen nicht exakt untereinander stehen – das ist nur für dich beim Lesen angenehmer. Verbundene Zellen kennt Markdown nicht; dafür brauchst du HTML.

Zitate, Trennlinien und Fußnoten

> Ein Zitat
>> Ein Zitat im Zitat

---

Ein Satz mit Fußnote.[^1]

[^1]: Der Text der Fußnote.

Drei Bindestriche, Sternchen oder Unterstriche erzeugen eine horizontale Trennlinie. Fußnoten sind eine Erweiterung und funktionieren nicht überall – prüf das in deiner Umgebung, bevor du dich darauf verlässt.

Zeilenumbrüche richtig setzen

Das ist die Frage, die am häufigsten Ärger macht. Ein einfacher Zeilenumbruch im Editor erzeugt in Markdown keinen Umbruch in der Ausgabe. Du hast drei Möglichkeiten:

• Neuer Absatz: eine komplett leere Zeile dazwischen. Das ist der Normalfall.
• Umbruch innerhalb des Absatzes: zwei Leerzeichen am Zeilenende. Unsichtbar und fehleranfällig, funktioniert aber überall.
• Umbruch, den man sieht: ein Backslash am Zeilenende oder direkt <br>.

Sonderzeichen maskieren

Wenn ein Sternchen wirklich ein Sternchen bleiben soll, stell einen Backslash davor: \*kein kursiv\*. Das gilt für alle Steuerzeichen von Markdown.

Markdown und HTML: Wo liegt der Unterschied?

Beide beschreiben Struktur, aber mit unterschiedlichem Anspruch. Markdown deckt die zwanzig Formatierungen ab, die du zu 95 Prozent brauchst. HTML deckt alles ab und ist entsprechend ausführlicher.

Das Verhältnis ist kein Gegensatz: Markdown wird zu HTML. Und wo Markdown nicht reicht – bei verbundenen Tabellenzellen, eingebetteten Videos, Formularen – schreibst du HTML einfach mitten in die Markdown-Datei. Die meisten Parser lassen es unverändert durch.

Die besten Markdown-Editoren

Für Markdown brauchst du streng genommen kein eigenes Programm. Der Windows-Editor oder TextEdit auf dem Mac genügen. Angenehmer wird es mit einer Live-Vorschau, mit Syntaxhervorhebung und mit Exportfunktionen.

Zwei Hinweise, die dir Recherche ersparen: Typora wird in vielen Übersichten als kostenlos geführt, ist es aber nach 15 Tagen nicht mehr. Und einige Klassiker aus älteren Listen sind nicht mehr in Entwicklung – Atom wurde am 15. Dezember 2022 eingestellt.

Wenn du nur kurz sehen willst, wie deine Syntax dargestellt wird, reicht eine Vorschauseite im Browser. Dafür brauchst du nichts zu installieren.

Markdown-Dateien speichern und umwandeln

Speicher deine Datei mit der Endung .md und in UTF-8, damit Umlaute erhalten bleiben. Für die Umwandlung in andere Formate gibt es zwei Wege:

• Über den Editor: Die meisten Programme exportieren direkt nach HTML, PDF oder DOCX.
• Über Pandoc: Das Kommandozeilenprogramm wandelt praktisch jedes Textformat in jedes andere. pandoc text.md -o text.docx erzeugt ein Word-Dokument, pandoc text.md -o text.pdf ein PDF. Mit einer Vorlagendatei kannst du Schriftarten und Überschriftenformate exakt vorgeben.

In die andere Richtung funktioniert es genauso: Word-Dokumente lassen sich in Markdown umwandeln. Damit das saubere Überschriften ergibt, arbeite in Word mit den Formatvorlagen „Überschrift 1" und „Überschrift 2" statt mit manuell vergrößertem Fettdruck – Umwandler erkennen Formatvorlagen, aber keine Absicht.

Markdown auf der eigenen Website veröffentlichen

Hier wird Markdown von einer Schreibhilfe zu einem Veröffentlichungsweg. Drei Varianten, je nach Vorwissen:

Statische Website-Generatoren

Programme wie Hugo, Eleventy, Astro, Jekyll oder Docusaurus machen genau eine Sache: Du legst Markdown-Dateien in einen Ordner, das Programm erzeugt daraus fertige HTML-Seiten. Diese Seiten lädst du per SFTP auf dein Webhosting – fertig. Kein Datenbankzugriff nötig, keine Anmeldemaske, entsprechend wenig Wartung. Für Dokumentationen, Blogs und Projektseiten ist das der direkteste Weg von Text zu Website.

Markdown in WordPress

Der Block-Editor versteht einige Markdown-Kurzschreibweisen bereits bei der Eingabe: Wenn du ## tippst, wird daraus eine Überschrift, - erzeugt eine Liste. Für vollständige Markdown-Unterstützung inklusive Import ganzer .md-Dateien gibt es Erweiterungen. Praktisch, wenn du Texte extern schreibst und nur noch einfügen willst.

Was du dafür brauchst

Zwei Dinge: eine Domain und einen Webspace, auf den du Dateien hochladen kannst. Wenn du noch keine Adresse hast, prüf zuerst, ob dein Wunschname frei ist – bei easyname stehen über 480 Domainendungen zur Auswahl. Für die Seiten selbst brauchst du Webhosting mit SFTP-Zugang; für eine statische Website reicht dabei ein kleines Paket völlig aus, weil keine Datenbank im Spiel ist. Wer den Generator gleich am Server laufen lassen möchte, findet auf einem VPS die nötige Umgebung dafür.

Drei Kleinigkeiten, die dir den Einstieg erleichtern

• Leerzeichen nach dem Steuerzeichen. #Überschrift wird nicht erkannt, # Überschrift schon. Dasselbe gilt für Listen.
• Leerzeile vor Blöcken. Listen, Tabellen und Codeblöcke brauchen davor eine leere Zeile, sonst verschmelzen sie mit dem Absatz darüber.
• Eine Variante wählen und dabeibleiben. Ob *kursiv* oder _kursiv_ ist Geschmackssache – Einheitlichkeit macht die Datei später leichter durchsuchbar.

Häufige Fragen zu Markdown

Ist Markdown schwer zu lernen?

Nein. Für Überschriften, Fettdruck, Listen und Links brauchst du rund zehn Minuten. Die Tabelle oben deckt so gut wie alles ab, was in der Praxis vorkommt, und du kannst jederzeit HTML dazwischenschreiben, wenn etwas fehlt.

Wie speichere ich eine Markdown-Datei?

Als reine Textdatei mit der Endung .md und der Zeichenkodierung UTF-8. Jeder Texteditor kann das.

Kann ich Markdown in HTML umwandeln?

Ja, das ist der eigentliche Zweck. Jeder Markdown-Editor bietet einen HTML-Export, Website-Generatoren machen es automatisch, und Pandoc kann es auf der Kommandozeile.

Unterstützt Markdown Tabellen?

Einfache Tabellen ja – über die GFM-Erweiterung, die in den meisten Umgebungen aktiv ist. Verbundene Zellen und verschachtelte Tabellen kennt Markdown nicht; dafür brauchst du HTML.

Was ist der Unterschied zwischen Markdown und CommonMark?

Markdown ist die Ursprungsvariante von 2004, deren Beschreibung an einigen Stellen mehrdeutig blieb. CommonMark ist die eindeutige Spezifikation dazu, aktuell in Version 0.31.2 vom 28. Jänner 2024, mit über 500 Prüfbeispielen. Für dich als Schreibende gilt: Die Syntax ist dieselbe, CommonMark legt nur die Randfälle verbindlich fest.

Warum geben KI-Assistenten ihre Antworten in Markdown aus?

Weil das Format strukturierte Information in Klartext ausdrückt – wenig Zeichen, klare Hierarchie, verlustfrei weiterverarbeitbar. Für dich heißt das: Wenn du KI-Antworten in Markdown weiterverwendest statt sie erst zu Fließtext zu glätten, bleibt die Struktur erhalten und lässt sich direkt weiterverwenden.

Brauche ich einen eigenen Markdown-Editor?

Nicht zwingend. Angenehm ist er wegen der Live-Vorschau und des Exports. Fürs Ausprobieren genügt ein Vorschaudienst im Browser.