Markdown-Syntax-Leitfaden: Von den Grundlagen bis Fortgeschritten

Markdown ist das Schreibformat, das Entwickler tatsächlich gerne nutzen. Kein Klicken durch Formatierungsmenüs, kein Kampf mit WYSIWYG-Editoren — nur Klartext mit ein paar Symbolen, der in sauberes HTML konvertiert wird. README-Dateien, Dokumentation, Blogbeiträge, Chat-Nachrichten und sogar dieser Artikel sind in Markdown geschrieben.

Sehen Sie Ihr Markdown in Echtzeit mit unserem Markdown Previewer — schreiben Sie auf einer Seite, sehen Sie die formatierte Ausgabe auf der anderen.

Grundlegende Syntax

Überschriften

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

Verwenden Sie Überschriften hierarchisch. Überspringen Sie keine Ebenen (von H1 zu H3 springen) — das schadet sowohl der Lesbarkeit als auch der Barrierefreiheit.

Hervorhebung

*italic* or _italic_
**bold** or __bold__
***bold italic***
~~strikethrough~~

Links und Bilder

[Link text](https://example.com)
[Link with title](https://example.com "Title")
![Alt text](image.png)

Listen

- Unordered item
- Another item
  - Nested item

1. First item
2. Second item
3. Third item

Blockzitate

> This is a blockquote.
> It can span multiple lines.

Code

Inline-Code

Verwenden Sie Backticks für Inline-Code: `const x = 42`

Codeblöcke

Dreifache Backticks mit optionalem Sprachbezeichner:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

Unterstützte Sprachen umfassen javascript, python, json, yaml, html, css, bash und viele mehr.

Tabellen

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

Ausrichtung:

| Left | Center | Right |
|:-----|:------:|------:|
| L    |   C    |     R |

Erweiterte Syntax

Aufgabenlisten

- [x] Completed task
- [ ] Pending task
- [ ] Another task

Fußnoten

Here is a statement[^1].

[^1]: This is the footnote content.

Definitionslisten

Term
: Definition of the term

Horizontale Linien

---
***
___

GitHub-Flavored Markdown (GFM)

GitHub erweitert Standard-Markdown um nützliche Funktionen:

Automatisch verlinkte URLs — Nackte URLs werden klickbar
Aufgabenlisten — Checkboxen in Issues und PRs
Tabellen — Die oben gezeigte Pipe-Syntax
Durchstreichen — ~~deleted text~~
Syntaxhervorhebung — Sprachspezifische Codefarben
Emoji — :smile: wird zu einem Smiley

Schreibtipps

Absätze kurz halten — maximal 3-5 Sätze
Überschriften verwenden, um eine scannbare Struktur zu schaffen
Listen gegenüber langen Absätzen für Schritte oder Funktionen bevorzugen
Codebeispiele hinzufügen, wenn technische Konzepte besprochen werden
Regelmäßig Vorschau anzeigen — unser Markdown Previewer zeigt die Ausgabe während Sie tippen

Häufig gestellte Fragen

Was ist der Unterschied zwischen Markdown und HTML?

Markdown ist ein vereinfachtes Schreibformat, das in HTML konvertiert wird. Es deckt die gängigsten Formatierungsbedürfnisse mit viel weniger Syntax ab. Sie können rohes HTML in Markdown einbetten, wenn Sie Funktionen benötigen, die Markdown nicht unterstützt.

Welchen Markdown-Dialekt sollte ich verwenden?

GitHub-Flavored Markdown (GFM) wird am weitesten unterstützt. Es fügt Tabellen, Aufgabenlisten und Durchstreichen zu Standard-Markdown hinzu. CommonMark ist die standardisierte Spezifikation.

Kann ich Markdown für Dokumentation verwenden?

Absolut. Markdown ist der Standard für README-Dateien, Wikis und Dokumentationsseiten. Tools wie MkDocs, Docusaurus und GitBook verwenden alle Markdown.