Markdown Spickzettel: Vollständige Referenzanleitung
· 12 Min. Lesezeit
Markdown ist zur universellen Sprache der Textformatierung im Web geworden. Ob Sie Dokumentation auf GitHub schreiben, auf Reddit posten, auf Discord chatten, Notizen in Notion organisieren oder Inhalte für unzählige andere Plattformen erstellen – Markdown ist überall. Das Erlernen dieser einfachen, aber leistungsstarken Syntax macht Sie in jedem digitalen Arbeitsbereich, den Sie nutzen, produktiver.
Dieser umfassende Leitfaden deckt alles ab, von der grundlegenden Formatierung bis zu fortgeschrittenen Techniken, komplett mit praktischen Beispielen und realen Anwendungsfällen. Setzen Sie ein Lesezeichen auf diese Seite als Ihre Anlaufstelle für alles rund um Markdown.
📑 Inhaltsverzeichnis
- Was ist Markdown und warum sollte man es verwenden?
- Grundlegende Textformatierung
- Überschriften und Dokumentstruktur
- Listen: Geordnet, ungeordnet und verschachtelt
- Links und Bilder
- Codeblöcke und Syntaxhervorhebung
- Tabellen erstellen
- Blockzitate und Zitierungen
- Erweiterte Markdown-Funktionen
- Markdown-Varianten und Erweiterungen
- Best Practices und häufige Fehler
- Häufig gestellte Fragen
Was ist Markdown und warum sollte man es verwenden?
Markdown ist eine leichtgewichtige Auszeichnungssprache, die 2004 von John Gruber entwickelt wurde. Die Philosophie ist einfach: Klartext sollte lesbar sein, wie er ist, aber auch in HTML und andere Formate konvertierbar sein. Im Gegensatz zu Rich-Text-Editoren, die Formatierungen hinter Schaltflächen und Menüs verbergen, hält Markdown alles sichtbar und portabel.
Die Schönheit von Markdown liegt in seiner Einfachheit. Sie können es in jedem Texteditor schreiben, mit Git versionieren und in HTML, PDF oder Dutzende andere Formate konvertieren. Es ist zum De-facto-Standard für technische Dokumentation, README-Dateien, Blogbeiträge und kollaboratives Schreiben geworden.
Wo Markdown verwendet wird:
- GitHub, GitLab und Bitbucket für README-Dateien und Dokumentation
- Reddit, Discord und Slack für formatierte Nachrichten
- Notion, Obsidian und Roam Research für Notizen
- Statische Site-Generatoren wie Jekyll, Hugo und Gatsby
- Content-Management-Systeme und Blogging-Plattformen
- Tools für technisches Schreiben und Dokumentationsplattformen
Profi-Tipp: Nutzen Sie unseren kostenlosen Markdown-Editor, um die Syntax in Echtzeit mit Live-Vorschau zu üben. Das ist der schnellste Weg, durch Praxis zu lernen.
Grundlegende Textformatierung
Die grundlegende Formatierungssyntax von Markdown ist intuitiv und leicht zu merken. Die meisten Formatierungen verwenden Sonderzeichen, die den zu formatierenden Text umgeben.
Fetter Text
Erstellen Sie fetten Text, indem Sie Wörter mit doppelten Sternchen oder doppelten Unterstrichen umschließen:
**Dieser Text ist fett**
__Dies ist auch fett__
Beide erzeugen: Dieser Text ist fett
Kursiver Text
Verwenden Sie einzelne Sternchen oder einzelne Unterstriche für kursiven Text:
*Dieser Text ist kursiv*
_Dies ist auch kursiv_
Beide erzeugen: Dieser Text ist kursiv
Fett und kursiv kombiniert
Kombinieren Sie beides, indem Sie drei Sternchen verwenden oder Sternchen und Unterstriche mischen:
***Fetter und kursiver Text***
**_Auch fett und kursiv_**
Ergebnis: Fetter und kursiver Text
Durchgestrichen
Die meisten Markdown-Varianten unterstützen Durchstreichungen mit doppelten Tilden:
~~Dieser Text ist durchgestrichen~~
Ergebnis: Dieser Text ist durchgestrichen
Inline-Code
Umschließen Sie Text mit einfachen Backticks, um ihn als Inline-Code zu formatieren:
Verwenden Sie die Funktion `console.log()` zum Debuggen.
Ergebnis: Verwenden Sie die Funktion console.log() zum Debuggen.
| Syntax | Ausgabe | Anwendungsfall |
|---|---|---|
**text** |
text | Betonung, wichtige Begriffe |
*text* |
text | Subtile Betonung, Buchtitel |
~~text~~ |
Gelöschter Inhalt, Korrekturen | |
`text` |
text |
Code, Befehle, Dateinamen |
Überschriften und Dokumentstruktur
Überschriften schaffen Dokumenthierarchie und verbessern die Lesbarkeit. Markdown unterstützt sechs Ebenen von Überschriften, entsprechend den HTML-Tags <h1> bis <h6>.
# Überschrift 1 (Größte)
## Überschrift 2
### Überschrift 3
#### Überschrift 4
##### Überschrift 5
###### Überschrift 6 (Kleinste)
Die Anzahl der Rautezeichen bestimmt die Überschriftenebene. Fügen Sie immer ein Leerzeichen zwischen den Rautezeichen und dem Überschriftentext ein.
Best Practice: Verwenden Sie Überschriftenebenen hierarchisch. Springen Sie nicht von H1 zu H4. Dies verbessert die Barrierefreiheit für Screenreader und hilft Suchmaschinen, Ihre Inhaltsstruktur zu verstehen.
Alternative Überschriftensyntax
Für H1 und H2 können Sie auch die Unterstreichungssyntax verwenden:
Überschrift 1
=============
Überschrift 2
-------------
Die Rautezeichen-Syntax ist jedoch gebräuchlicher und unterstützt alle sechs Ebenen.
Best Practices für Überschriften
- Verwenden Sie nur eine H1 pro Dokument (typischerweise der Titel)
- Halten Sie Überschriften prägnant und beschreibend
- Verwenden Sie durchgehend Satzschreibweise oder Titelschreibweise
- Beenden Sie Überschriften nicht mit Satzzeichen
- Fügen Sie Leerzeilen vor und nach Überschriften für bessere Lesbarkeit ein
Listen: Geordnet, ungeordnet und verschachtelt
Listen sind grundlegend für die Organisation von Informationen. Markdown unterstützt ungeordnete (Aufzählungs-)Listen, geordnete (nummerierte) Listen und verschachtelte Kombinationen von beiden.
Ungeordnete Listen
Erstellen Sie Aufzählungslisten mit Sternchen, Bindestrichen oder Pluszeichen. Alle drei erzeugen identische Ausgaben:
* Erstes Element
* Zweites Element
* Drittes Element
- Erstes Element
- Zweites Element
- Drittes Element
+ Erstes Element
+ Zweites Element
+ Drittes Element
Wählen Sie einen Stil und bleiben Sie dabei im gesamten Dokument für Konsistenz.
Geordnete Listen
Nummerieren Sie Ihre Listenelemente mit Punkten. Die tatsächlichen Zahlen spielen keine Rolle – Markdown nummeriert sie automatisch neu:
1. Erstes Element
2. Zweites Element
3. Drittes Element
1. Erstes Element
1. Zweites Element
1. Drittes Element
Beide erzeugen dieselbe nummerierte Liste. Die Verwendung von nur Einsen erleichtert das Neuordnen von Elementen ohne Neunummerierung.
Verschachtelte Listen
Rücken Sie verschachtelte Elemente mit 2 oder 4 Leerzeichen ein (seien Sie konsistent):
1. Erstes Element
- Verschachtelter Aufzählungspunkt
- Weiterer verschachtelter Aufzählungspunkt
2. Zweites Element
1. Verschachtelte Nummer
2. Weitere verschachtelte Nummer
Aufgabenlisten
Viele Markdown-Varianten unterstützen Aufgabenlisten mit Kontrollkästchen:
- [x] Erledigte Aufgabe
- [ ] Unerledigte Aufgabe
- [ ] Weitere unerledigte Aufgabe
Dies ist besonders nützlich in GitHub-Issues und Projektmanagement-Tools.
Schneller Tipp: Wenn Sie mehrzeilige Listenelemente schreiben, rücken Sie nachfolgende Absätze so ein, dass sie mit der ersten Textzeile übereinstimmen, nicht mit dem Aufzählungszeichen.
Links und Bilder
Markdown macht es einfach, Hyperlinks und Bilder hinzuzufügen, ohne Ihren Text mit HTML-Tags zu überladen.
Einfache Links
Die Syntax für Links ist unkompliziert: eckige Klammern für den Linktext, gefolgt von runden Klammern für die URL:
[Besuchen Sie unseren Markdown-Editor](/tools/markdown-editor/)
Ergebnis: Besuchen Sie unseren Markdown-Editor
Links mit Titeln
Fügen Sie ein Titelattribut (wird beim Hovern angezeigt) hinzu, indem Sie es in Anführungszeichen nach der URL einfügen:
[GitHub](https://github.com "GitHub besuchen")
Referenzstil-Links
Für Dokumente mit vielen wiederholten Links verwenden Sie die Referenzstil-Syntax, um Ihren Text sauber zu halten:
Schauen Sie sich [Google][1] und [GitHub][2] für weitere Informationen an.
[1]: https://google.com "Google"
[2]: https://github.com "GitHub"
Die Referenzdefinitionen können überall im Dokument erscheinen und sind in der Ausgabe nicht sichtbar.
Automatische Links
Umschließen Sie URLs oder E-Mail-Adressen mit spitzen Klammern, um sie anklickbar zu machen:
<https://example.com>
<email@example.com>
Viele Markdown-Prozessoren verlinken auch nackte URLs automatisch ohne spitze Klammern.
Bilder
Die Bildsyntax ist identisch mit Links, aber mit einem vorangestellten Ausrufezeichen:


Der Alternativtext ist entscheidend für Barrierefreiheit und SEO. Geben Sie immer beschreibenden Alternativtext an, der erklärt, was das Bild zeigt.
Best Practices für Bilder
- Schreiben Sie beschreibenden Alternativtext für Barrierefreiheit
- Verwenden Sie relative Pfade für Bilder im selben Repository
- Optimieren Sie Bilddateigrößen für schnelleres Laden
- Erwägen Sie die Verwendung von Referenzstil-Syntax für wiederholte Bilder
- Testen Sie, dass Bilder auf Ihrer Zielplattform korrekt angezeigt werden
Codeblöcke und Syntaxhervorhebung
Codeblöcke sind essentiell für technische Dokumentation. Markdown bietet mehrere Möglichkeiten, Code zu formatieren, von Inline-Snippets bis zu mehrzeiligen Blöcken mit Syntaxhervorhebung.
Inline-Code
Wie bereits erwähnt, umschließen Sie Inline-Code mit einfachen Backticks:
Verwenden Sie den Befehl `git commit`, um Änderungen zu speichern.
Umzäunte Codeblöcke
Für mehrzeiligen Code verwenden Sie dreifache Backticks (oder dreifache Tilden) vor und nach dem Code:
```
function greet(name) {
return `Hello, ${name}!`;
}
```
Syntaxhervorhebung
Geben Sie die Programmiersprache nach den öffnenden Backticks an für Syntaxhervorhebung:
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
```python
def greet(name):
return f"Hello, {name}!"
```
```css
.button {
background-color: #06b6d4;
border-radius: 8px;
}
```
Die meisten Markdown-Prozessoren unterstützen Dutzende von Sprachen, darunter JavaScript, Python, Java, C++, Ruby, Go, Rust, SQL, HTML, CSS und viele mehr.
Eingerückte Codeblöcke
Eine ältere Syntax verwendet 4-Leerzeichen-Einrückung, um Codeblöcke zu erstellen:
function example() {
return true;
}
Umzäunte Codeblöcke werden jedoch bevorzugt, da sie Syntaxhervorhebung unterstützen und im Klartext leichter zu lesen sind.
Profi-Tipp: Verwenden Sie unseren HTML-Verschönerer, um Code zu formatieren, bevor Sie ihn in Markdown-Dokumente einfügen. Sauberer, gut formatierter Code ist leichter zu lesen und zu pflegen.
Tabellen erstellen
Tabellen organisieren Daten in Zeilen und Spalten. Obwohl Markdown-Tabellen nicht so flexibel wie HTML-Tabellen sind, sind sie perfekt für einfache Datenpräsentation.
Grundlegende Tabellensyntax
Erstellen Sie Tabellen mit Pipes und Bindestrichen:
| Kopfzeile 1 | Kopfzeile 2 | Kopfzeile 3 |
|-------------|-------------|-------------|
| Zelle 1 | Zelle 2 | Zelle 3 |
| Zelle 4 | Zelle 5 | Zelle 6 |
Die Pipes müssen nicht perfekt ausgerichtet sein – Markdown-Prozessoren formatieren sie korrekt. Ausgerichtete Pipes machen Tabellen jedoch im Klartext leichter lesbar.
Spaltenausrichtung
Steuern Sie die Textausrichtung mit Doppelpunkten in der Trennzeile:
| Linksbündig | Zentriert | Rechtsbündig |
|:------------|:-------------:|-------------:|
| Text | Text | Text |
| Mehr Text | Mehr Text | Mehr Text |
:---richtet links aus (Standard):---:zentriert Text---:richtet rechts aus
Praktisches Tabellenbeispiel
| Markdown-Variante | Tabellen | Aufgabenlisten | Fußnoten |
|---|---|---|---|
| CommonMark | ❌ Nein | ❌ Nein |