diff --git a/docs/content/mdsyntax.de.md b/docs/content/mdsyntax.de.md
index e3309348a9e6f82804299c644cb4253881d5b365..7c311153e7e3ebfdab29f0bddc3d8c5dcaa48d95 100644
--- a/docs/content/mdsyntax.de.md
+++ b/docs/content/mdsyntax.de.md
@@ -3,10 +3,106 @@ title: "Markdown Syntax"
 prio: 4
 ---
 
+:::info
+Die Markdown Syntax baut auf der [Markdown Syntax von Pandoc](https://pandoc.org/MANUAL.html#pandocs-markdown) auf. Es sind einige Extensions aktiviert, um die Syntax möglichst ähnlich zur [Hedgedoc Markdown Syntax](https://pad.gwdg.de/features) zu machen.
+
+Die vollständige Markdown Syntax die verwendet werden kann ist also sehr umfangreich. Dieses Dokument *sollte* alle Features und Schreibweisen aufzeigen.
+:::
+
+Markdowncodebeispiele zusammen mit den entsprechenden Ergebnissen die generiert wurden sehen in diesem Dokument wie folgt aus:
+```markdown
+Ich bin ein *Markdown* Beispiel.
+```
+
+:::success
+Ich bin ein *Markdown* Beispiel.
+:::
+
+## Paragraphen
+
+Ein Paragraph besteht aus einer oder mehr Zeilen an Text gefolgt von einer oder mehreren Leerzeilen.
+Ein Zeilenumbruch in einem Paragraphen wird, wie in Hedgedoc auch, direkt auf der Webseite als Zeilenumbruch übernommen.
+
+```markdown
+Dies ist der erste Paragraph.
+
+Dies ist der zweite Paragraph und dieser Paragraph
+beinhaltet sogar einen Zeilenumbruch.
+```
+
+:::success
+Dies ist der erste Paragraph.
+
+Dies ist der zweite Paragraph und dieser Paragraph
+beinhaltet sogar einen Zeilenumbruch.
+:::
+
+## Ãœberschriften
+
+
+Es gibt zwei Arten Ãœberschriften zu schreiben: [Setext](#setext) und [ATX](#atx).
+
+In Ãœberschriften kann [Inlinemarkup](#inlinemarkup) verwendet werden.
+
+Eine Leerzeile vor oder nach einer Ãœberschrift ist nicht notwendig.
+
 :::warning
-TODO Markdown Syntax konkret dokumentieren!
+Jede Seite wird automatisch mit einer Level 1 Ãœberschrift aus dem Titel generiert.
+Entsprechend sollten die meisten Dokumente nur Level 2-6 Ãœberschriften verwenden!
 :::
 
+:::warning
+Ãœberschriften haben semantische Bedeutung welche von Browsern, Bots und Screenreadern interpretiert und verwendet wird.
+Überschriften sollten deshalb _niemals_ verwendet werden um Text einfach nur **fettgedruckt** oder in einer bestimmten Schriftgröße zu schreiben weil es ja "gut aussehen würde".
+:::
+
+### Setext
+
+
+Setext-Style Überschriften bestehen jeweils aus einer Zeile mit dem Überschriftstext gefolgt von einer Zeile mit `=`-Symbolen (für eine Level 1 Überschrift) oder  `-`-Symbolen (für eine Level 2 Überschrift).
+
+```markdown
+Eine Level 1 Ãœberschrift
+========================
+
+Eine Level 2 Ãœberschrift
+------------------------
+```
+
+:::success
+Eine Level 1 Ãœberschrift
+========================
+
+Eine Level 2 Ãœberschrift
+------------------------
+:::
+
+
+### ATX
+
+ATX-Style Ãœberschriften bestehen jeweils aus einer Zeile mit ein bis sechs `#`-Symbolen gefolgt von mindestens einem Leerzeichen, dem jeweiligen Ãœberschriftstext und einer optionalen Menge an weiteren `#`-Symbolen.
+Die Anzahl der `#`-Symbole am Anfang der Zeile gibt das Level an.
+
+```markdown
+# Eine Level 1 Ãœberschrift
+## Eine Level 2 Ãœberschrift
+### Eine Level 3 Ãœberschrift ###
+#### Eine Level 4 Ãœberschrift
+##### Eine Level 5 Ãœberschrift
+###### Eine Level 6 Ãœberschrift
+```
+
+:::success
+# Eine Level 1 Ãœberschrift
+## Eine Level 2 Ãœberschrift
+### Eine Level 3 Ãœberschrift ###
+#### Eine Level 4 Ãœberschrift
+##### Eine Level 5 Ãœberschrift
+###### Eine Level 6 Ãœberschrift
+:::
+
+:::danger
+TODO continue https://pandoc.org/MANUAL.html#extension-header_attributes
+:::
 
-Die Markdown Syntax baut auf der Markdown Syntax von Pandoc auf. Es sind einige Extensions aktiviert, um die Syntax möglichst ähnlich zur Hedgedoc Markdown Syntax zu machen.
-Einen Überblick über die Hedgedoc Markdown Syntax gibt es [hier](https://pad.gwdg.de/features)
+## Inlinemarkup