Markdown-Referenz: Schneller Überblick zu Syntax, Formatierung & Struktur
Schnellreferenz für Markdown: Überschriften, Listen, Code, Tabellen & mehr.
Markdown-Sprache wird in Wikipedia und Hugo verwendet. Sie unterstützt Überschriften, Listen, Schriftstiländerungen, Bilder, Codeblöcke und Tabellen. Hier fasse ich die Markdown-Formatierung kurz zusammen.
Das obige Bild wurde von Flux – Text-zu-Bild-KI erstellt.
Markdown ist eine lightweight Markup-Sprache, mit der Sie Textelementen in Klartextdokumenten Formatierungen hinzufügen können. Dieser Leitfaden bietet einen umfassenden Überblick über die am häufigsten verwendeten Markdown-Syntax, der Ihnen hilft, gut strukturierte und visuell ansprechende Dokumente zu erstellen.
Dieser Cheatsheet ist Teil des Dokumentationstools im Jahr 2026: Markdown, LaTeX, PDF & Druck-Workflows Hub.
Markdown-Überschriften (H1–H6)
Überschriften in Markdown werden mit dem Hash-Symbol (#) erstellt. Die Anzahl der Hashes vor dem Überschriftentext gibt die Ebene der Überschrift an.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Fett, Kursiv und Hervorhebung
Markdown bietet verschiedene Möglichkeiten, Text hervorzuheben. Sie können Sternchen (*) oder Unterstriche (_) für Kursivschrift und doppelte Sternchen (**) oder doppelte Unterstriche (__) für Fettschrift verwenden.
Kursiv
*Kursiv* oder _kursiv_
Fett
**Fett** oder __fett__
Fett und Kursiv
***Fett und kursiv*** oder ___fett und kursiv___
Geordnete und ungeordnete Listen
Markdown unterstützt sowohl geordnete als auch ungeordnete Listen.
Ungeordnete Liste
- Element 1
- Element 2
- Unterelement 1
- Unterelement 2
Geordnete Liste
1. Erstes Element
2. Zweites Element
1. Unterelement 1
2. Unterelement 2
Hyperlinks in Markdown
Sie können Links erstellen, indem Sie den Linktext in eckige Klammern ([]) und die URL in runde Klammern (()) setzen.
[Linktext](URL)
Beispiel
Besuchen Sie den [Markdown-Leitfaden](https://www.markdownguide.org/) für weitere Informationen.
Einbetten von Bildern
Bilder werden mit einem Ausrufezeichen (!) hinzugefügt, gefolgt vom Alternativtext in eckigen Klammern und der Bild-URL in runden Klammern.
Beispiel
Blockzitate und verschachtelte Zitate
Blockzitate werden mit dem Größer-als-Symbol (>) erstellt.
> Dies ist ein Blockzitat.
Verschachtelte Blockzitate
> Dies ist die erste Ebene des Zitierens.
>> Dies ist ein verschachteltes Blockzitat.
Inline-Code und Code-Blöcke
Sie können Inline-Code hinzufügen, indem Sie ihn in Backticks (` ) setzen. Für Code-Blöcke verwenden Sie dreifache Backticks (``` ) vor und nach dem Code.
Inline-Code
Verwenden Sie `printf()` zum Drucken von Text in C.
Code-Blöcke
```python
python def hello_world(): print("Hello, World!")
```
Mehr über Code-Blöcke in Markdown – siehe separaten Beitrag: Verwenden von Markdown-Code-Blöcken. Die mermaid-Sprachenkennung ist ein bemerkenswerter Sonderfall – sie löst die Diagrammrenderung aus, anstatt Syntax-Hervorhebung zu verwenden, und verwandelt einen einfachen Code-Block in ein Flussdiagramm oder Sequenzdiagramm. Die Mermaid-Diagramme Schnellstart deckt die vollständige Diagrammsyntax von Flussdiagrammen bis zu ER-Diagrammen ab.
Horizontale Trennlinien (Trenner)
Horizontale Trennlinien werden mit drei oder mehr Bindestrichen (—), Sternchen (***) oder Unterstrichen (___) erstellt.
---
Tabellen
Tabellen in Markdown werden mit Pipes (|) und Bindestrichen (-) erstellt.
Beispiel
| Kopfzeile 1 | Kopfzeile 2 |
|----------|----------|
| Zelle 1 | Zelle 2 |
| Zelle 3 | Zelle 4 |
Für Ausrichtungsoptionen, mehrspaltige Formatierung und GFM-spezifische Funktionen siehe die Tabellen in Markdown: Kompletter Leitfaden.
Aufgabenlisten (Kontrollkästchen)
Aufgabenlisten sind eine spezielle Art von Liste, mit der Sie Kontrollkästchen erstellen können.
Beispiel
- [x] Erledigte Aufgabe
- [ ] Unvollständige Aufgabe
Durchgestrichener Text
Durchgestrichener Text wird mit doppelten Tilden (~~) erstellt.
~~Dies ist durchgestrichener Text.~~
Text-Hervorhebung
Text-Hervorhebung wird in Markdown nicht nativ unterstützt, aber einige Renderer unterstützen sie mit der ==-Syntax.
Beispiel
==Dies ist hervorgehobener Text.==
Indices und Exponenten
Subskripte (Indizes) werden mit einem Caret (^) vor dem Text erstellt, und Superskripte (Exponenten) werden mit einer Tilde (~) vor dem Text erstellt.
Beispiel
H~2~O ist Wasser.
E = mc^2
Mathematische Gleichungen (LaTeX-Syntax)
Mathematische Gleichungen können mit LaTeX-Syntax innerhalb von Dollarzeichen ($) hinzugefügt werden.
Beispiel
$$ E = mc^2 $$
Escape von Sonderzeichen
Um Sonderzeichen zu escapen, verwenden Sie einen Backslash ().
Beispiel
\*Kursiv\* oder \_kursiv\_
Dieser umfassende Cheatsheet deckt die wesentliche Markdown-Syntax ab, die Sie benötigen, um gut formatierte Dokumente zu erstellen. Für fortgeschrittene Funktionen und Anpassungen beziehen Sie sich auf die Dokumentation des spezifischen Renderers oder zusätzliche Ressourcen. Wenn Sie Hugo verwenden, ist das Hugo-Befehle-Cheatsheet eine hilfreiche Referenz.
Markdown ist auch das Standardspeicherformat für selbst gehostete Wikis und Wissenssysteme. DokuWiki verwendet einen Markdown-freundlichen Klartext-Ansatz für persönliche und Team-Wissensdatenbanken. Für KI-gestützte Wissenssysteme, die auf Markdown-Seiten basieren, erklärt LLM Wiki, warum die Portabilität und Diffbarkeit des Formats es zur richtigen Grundlage für kompiliertes Wissen machen.
