152 lines
2.5 KiB
Markdown
152 lines
2.5 KiB
Markdown
---
|
|
tags:
|
|
- HowTo
|
|
---
|
|
|
|
# Markdown Tutorial
|
|
|
|
Markdown ist eine vereinfachte Auszeichnungssprache. Markdown-Dateien sind einfache Text-Dateien, die zur Darstellung in HTML-Seiten umgewandelt werden. Das Markdown-Markup hat zum Ziel als Textdatei und als HTML-Seite leserlich zu bleiben.
|
|
|
|
## Basis
|
|
|
|
Die [Basissyntax](https://www.markdownguide.org/basic-syntax/) umfasst eine übersichliche Anzahl Befehle. Dazu eine Auswahl der wichtigsten:
|
|
|
|
## Text
|
|
|
|
Alle Text-Formatierungen.
|
|
|
|
### Überschriften
|
|
|
|
Markup:
|
|
|
|
```
|
|
# Überschrift 1
|
|
## Überschrift 2
|
|
### Überschrift 3
|
|
Normal
|
|
```
|
|
|
|
Output:
|
|
|
|
# Überschrift 1
|
|
|
|
## Überschrift 2
|
|
|
|
### Überschrift 3
|
|
|
|
Normal
|
|
|
|
### Fett
|
|
|
|
Markup:
|
|
|
|
```
|
|
**Lorem** ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
|
|
```
|
|
|
|
Output:
|
|
|
|
**Lorem** ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
|
|
|
|
### Kursiv
|
|
|
|
Markup:
|
|
|
|
```
|
|
*Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
|
|
```
|
|
|
|
Output:
|
|
|
|
_Lorem_ ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
|
|
|
|
## Erweiterungen
|
|
|
|
Zur Basissyntax von Markdown gibt es verschiedene [Erweiterungen](https://www.markdownguide.org/extended-syntax/).
|
|
|
|
### Vuepress
|
|
|
|
Das Set an Markdown-Befehlen wurde von Dritten erweitert. [[Vuepress]] können zusätzliche Markdown-Formatierungen verwendet werden.
|
|
|
|
#### Markierung
|
|
|
|
Um Inhalte speziell zu markieren gibt es diese Optionen.
|
|
|
|
Markup:
|
|
|
|
```
|
|
::: tip
|
|
Info
|
|
:::
|
|
|
|
::: warning
|
|
Warnung
|
|
::: tip
|
|
```
|
|
|
|
Output:
|
|
|
|
::: tip
|
|
Info
|
|
:::
|
|
|
|
::: warning
|
|
Warnung
|
|
:::
|
|
|
|
### GitHub
|
|
|
|
GitHub ist eine Kollaborationsplattform zur Entwicklung von Software. Es erweitert Markdown um einige Funktionen.
|
|
|
|
#### Aufgaben
|
|
|
|
Aufgaben können auf GitHub direkt bearbeitet werden.
|
|
|
|
Markup:
|
|
|
|
```
|
|
- [ ] foo
|
|
- bar
|
|
- [x] baz
|
|
- [] bam <~ not working
|
|
- [ ] bim
|
|
- [ ] lim
|
|
```
|
|
|
|
Output:
|
|
|
|
- [ ] foo
|
|
- bar
|
|
- [x] baz
|
|
- [] bam <~ not working
|
|
- [ ] bim
|
|
- [ ] lim
|
|
|
|
### Mermaid
|
|
|
|
Mit [mermaid](https://mermaid-js.github.io/mermaid/) erstellt man Diagramme basierend auf Markdown-inspierten Textdefinitionen.
|
|
|
|
#### Flowchart
|
|
|
|
Markup:
|
|
|
|
````
|
|
```mermaid
|
|
graph TD;
|
|
A-->B;
|
|
A-->C;
|
|
B-->D;
|
|
C-->D;
|
|
```
|
|
````
|
|
|
|
Output:
|
|
|
|
```mermaid
|
|
graph TD;
|
|
A-->B;
|
|
A-->C;
|
|
B-->D;
|
|
C-->D;
|
|
```
|