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)