Der folgende Überblick basiert auf: <https://guides.github.com/features/mastering-markdown/>


# Allgemeines

Markdown ist eine sehr Auszeichnungssprache zur Formatierung von Text mit sehr übersichtlicher Syntax.

# Markdown-Beispiele

Am einfachsten ist Markdown zu verstehen, wenn man sich die Quellcode-Beispiel und das jeweilige Ergebnis anschaut.

Am häufigsten braucht man Überschriften. Diese erzeugt man mit Rauten:

```
# Ebene 1 (z. B. Kapitel)
## Ebene 2  (z. B. Abschnitt)
...
###### Ebene 6
```

# Ebene 1 (z. B. Kapitel)
## Ebene 2  (z. B. Abschnitt)
...
###### Ebene 6

---

```
Zur Texthervorhebung gibt es die Eigenschaften **fett**  und *kursiv*.
```

Zur Texthervorhebung gibt es die Eigenschaften **fett**  und *kursiv*.

---

Es gibt nummerierte Listen...

```
1. wobei zu
2. beachten ist,
2. dass die Nummerierung im Quelltext
1. nicht fortlaufend sein muss.
    1. Und Einrückungen
    1. zur Untergliederung
        2. genutzt werden können.
```

1. Wobei zu
2. beachten ist,
2. dass die Nummerierung im Quelltext
1. nicht fortlaufend sein muss.
    1. Und Einrückungen
    1. zur Untergliederung
        2. genutzt werden können.

---

Unsortierte Liste nutzen - als Aufzählungszeichen:



```
- So
- wie 
  - in diesem
  - Beispiel,
    - ebenfalls mit Untergliederungen.
```

- So
- wie 
  - in diesem
  - Beispiel,
    - ebenfalls mit Untergliederungen.

---

Links kann man auf mehrere Arten anlegen, z.B.:

```
- In spitzen Klammern: <https://bits-und-baeume.org/>
- Mit einer Kombination aus Klammern
  - eckige  für den Link-Text
  - runde für die URL: [Bits&Bäume-Hauptseite](https://bits-und-baeume.org/)
```

- In spitzen Klammern: <https://bits-und-baeume.org/>
- Mit einer Kombination aus Klammern:
  - eckige  für den Link-Text
  - runde für die URL: [Bits&Bäume-Hauptseite](https://bits-und-baeume.org/)

---

Die Benutzung des **Preview-Buttons** links unten ist empfehlenswert, vor dem Speichern der Seite.

---

Markdown hat noch mehr Möglichkeiten: 

- Bilder
- Tabellen
- Eingebettetes HTML
- Code (inline und als Block)

Markdown-Anleitungen gibt es viele, wobei manche Plattformen noch zusätzliche Features aktiviert haben, die hier im Wiki nicht funktionieren. Für weitere Informationen wird auf  folgende Quellen verwiesen:

- <https://daringfireball.net/projects/markdown/syntax> Original-Doku vom Erfinder
- <https://guides.github.com/features/mastering-markdown/> Guter kompakter Überblick (1)
- <https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet> Guter kompakter Überblick (2)