Markdown-Syntax-Leitfaden: Vollständige Referenz mit Beispielen

Markdown-Syntax-Leitfaden

Markdown ist eine leichtgewichtige Auszeichnungssprache, die Klartext in formatiertes HTML umwandelt. 2004 von John Gruber entwickelt, ist es zum Standardformat für Dokumentationen, README-Dateien und technische Inhalte im gesamten Web geworden.

Überschriften

Verwenden Sie #-Symbole. Ein # für die oberste Ebene, bis zu sechs für die tiefste:

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

Die Ebenen sollten jeweils um eins ansteigen — ein Überspringen von ## auf #### kann Bildschirmleseprogramme verwirren.

Textformatierung

**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

Links

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

Bilder

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

Alt-Text ist entscheidend für Barrierefreiheit und SEO — er wird angezeigt, wenn Bilder nicht geladen werden können.

Listen

Ungeordnete Listen verwenden -, * oder +. Geordnete Listen verwenden Zahlen:

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

Code

Inline-Code verwendet einfache Backticks: `printf()`.

Codeblöcke verwenden dreifache Backticks mit optionaler Sprachkennung:

```python
def greet(name):
    return f"Hello, {name}!"

Unterstützte Sprachen: `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`.

## Blockzitate

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

Häufig verwendet für Hervorhebungen, Hinweise und Zitate aus externen Quellen.

Horizontale Linien

Drei oder mehr Bindestriche, Sternchen oder Unterstriche in einer Zeile:

---
***
___

Tabellen

Senkrechte Striche (Pipes) und Bindestriche definieren die Spalten. Doppelpunkte steuern die Ausrichtung:

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

GitHub Flavored Markdown-Erweiterungen

GitHub Flavored Markdown (GFM) fügt nützliche Funktionen hinzu:

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

GFM verlinkt URLs auch automatisch — www.example.com wird klickbar, ohne es in < > einzuschließen.

Maskieren von Sonderzeichen

Stellen Sie \ voran, um Markdown-Zeichen wörtlich anzuzeigen:

\*This is not italic\*
\# This is not a heading

Zeichen, die maskiert werden müssen: \ ` * _ { } [ ] ( ) # + - . ! | ~.

Markdown online als Vorschau anzeigen

Verwenden Sie das Markdown-Vorschau-Tool, um Markdown in Echtzeit zu schreiben und als Vorschau anzuzeigen. Die Live-Vorschau aktualisiert sich während der Eingabe und zeigt genau, wie Überschriften, Links, Bilder, Codeblöcke und Tabellen gerendert werden.