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 umfasst eine übersichliche Anzahl Befehle. Dazu eine Auswahl der wichtigsten:
Text¶
Alle Text-Formatierungen.
Überschriften¶
Markup:
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.
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:
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:
Output:
- foo
- bar
- baz
- [] bam <~ not working
- bim
- lim
Mermaid¶
Mit mermaid erstellt man Diagramme basierend auf Markdown-inspierten Textdefinitionen.
Flowchart¶
Markup:
Output:
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
Backlinks