Newer
Older
:::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.
:::
## Inhaltsverzeichnis
Ein Paragraph mit einzigem Inhalt `[TOC]` generiert ein Inhaltsverzeichnis.
```markdown
[TOC]
```
:::success
[TOC]
:::
## 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
Überschriften werden genutzt um ein Dokument zu strukturieren.
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.
### Nutzungsinformationen
- Jede Seite wird automatisch mit einer Level 1 Überschrift aus dem Titel generiert.
Entsprechend sollten die meisten Dokumente nur Level 2-6 Überschriften verwenden!
- Ü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".
- Es sollte vermieden werden Überschriftenlevel zu überspringen. Siehe [hier](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements#navigation) für eine Erklärung.
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
### 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
:::
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
### Identifikator, Attribute und Klassen
Am Ende der Zeile mit dem Überschriftentext kann man auch optionale Metadaten hinzugefügen.
Dafür schreibt man leerzeichengetrennt in geschweiften Klammern die folgenden Dinge:
- den Identifikator: `#Identifikator` (maximal einmal)
- die Klassen: `.eine-klasse .eine-andere-klasse .noch-eine-klasse`
- Die Klasse `.unnumbered` makiert eine Überschrift als "soll nicht nummeriert werden". Als Alias reicht auch ein `-`.
- Die Klasse `.unlisted` makiert eine Überschrfit als "soll im Inhaltsverzeichnis nicht eingetragen werden".
In den meisten Fällen wird maximal der Identifikator benötigt.
Der Identifaktor kann zum verlinken des entsprechenden Abschnittes verwendet werden.
```markdown
#### Eine Überschrift {#bspueberschrift}
#### Eine andere Überschrift {#anderebspueberschrift .mit-klassen .foobar}
#### Nich Nummeriert und nicht im Inhaltsverzeichnis {- .unlisted}
```
:::success
#### Eine Überschrift {#bspueberschrift}
#### Eine andere Überschrift {#anderebspueberschrift .mit-klassen .foobar}
#### Nich Nummeriert und nicht im Inhaltsverzeichnis {- .unlisted}
:::
:::info
Falls kein Identifikator für eine Überschrift gesetzt wurde, wird automatisch einer aus dem Überschriftentext generiert.
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
Es gibt einige Inlinemarkups.
Die simplesten sind im folgenden Beispiel aufgezeigt.
```markdown
Normaler Text
**Fettgedruckter Text**
__Fettgedruckter Text__
*Kursiv gesetzter Text*
_Kursiv gesetzter Text_
~~Durchgestichener Text~~
"Schöne doppelte Anführungszeichen"
'Schöne einfache Anführungszeichen'
Superscript: 19^th^
Subscript: H~2~O
Hinweis: Superscript und Subscript ~funktioniert nur~ ohne ^Leerzeichen dazwischen^. Es sei denn ~man\ escaped~ ^die\ Leerzeichen^.
Geviertstriche werden mit zwei oder drei Minuszeichen gemacht:
Schön---nein, unfassbar!
Während 1980--1988.
***Gemischte*** ~~_Syntax_~~ __~geht~__ **_^auch^_**
```
:::success
Normaler Text
**Fettgedruckter Text**
__Fettgedruckter Text__
*Kursiv gesetzter Text*
_Kursiv gesetzter Text_
~~Durchgestichener Text~~
"Schöne doppelte Anführungszeichen"
'Schöne einfache Anführungszeichen'
Superscript: 19^th^
Subscript: H~2~O
Hinweis: Superscript und Subscript ~funktioniert nur~ ohne ^Leerzeichen dazwischen^. Es sei denn ~man\ escaped~ ^die\ Leerzeichen^.
Geviertstriche werden mit zwei oder drei Minuszeichen gemacht:
Schön---nein, unfassbar!
Während 1980--1988.
***Gemischte*** ~~_Syntax_~~ __~geht~__ **_^auch^_**
:::
https://pandoc.org/MANUAL.html#underline
https://pandoc.org/MANUAL.html#small-caps
https://pandoc.org/MANUAL.html#extension-smart
https://pandoc.org/MANUAL.html#emphasis
https://pandoc.org/MANUAL.html#highlighting
https://pandoc.org/MANUAL.html#strikeout
https://pandoc.org/MANUAL.html#superscripts-and-subscripts
:::
"Strong" :{"handler" : InlineSimple, "etype":"strong" },
"Emph" :{"handler" : InlineSimple, "etype":"emph" },
"Underline" :{"handler" : InlineSimple, "etype":"underline" },
"Strikeout" :{"handler" : InlineSimple, "etype":"strikeout" },
"Superscript":{"handler" : InlineSimple, "etype":"superscript"},
"Subscript" :{"handler" : InlineSimple, "etype":"subscript" },
"SmallCaps" :{"handler" : InlineSimple, "etype":"smallcaps" },
"Quoted" : InlineQuoted,
"SoftBreak" : InlineSoftBreak,
"LineBreak" : InlineLineBreak,
Die restlichen Inlinemarkups sind in den folgenden Unterabschnitten genauer beschrieben.
https://pandoc.org/MANUAL.html#links-1
https://pandoc.org/MANUAL.html#extension-abbreviations
https://pandoc.org/MANUAL.html#extension-implicit_header_references
:::
"Link" : InlineLink,
### Bilder
:::danger
TODO
### :point_right: Emoji :point_left:
Es gibt Emojis! :smiley:
Eine Auflistung *aller* 1855 möglichen Emojis findest du in der [Emojiliste](slug:emojis).
```markdown
Fühl dich gedrückt :hugs: :hearts:
```
:::success
Fühl dich gedrückt :hugs: :hearts:
<!-- https://pandoc.org/MANUAL.html#extension-emoji -->
https://pandoc.org/MANUAL.html#math-input
https://pandoc.org/MANUAL.html#math
https://pandoc.org/MANUAL.html#extension-tex_math_single_backslash
:::
"Math" : InlineMath,
### Code
:::danger
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
### Backslash-Escape
Außer in [Codeblöcken](#codeblocke) oder [Inline Code](#code), werden alle Zeichensetzungen oder Leerzeichen, welche direkt auf ein Backslash folgen, als Literale gelesen.
```markdown
*Dieser Text ist kursiv.*
\*Dieser Text hat Sternchen.\*
*\*Dieser Text hat Sternchen und ist kursiv.\**
```
:::success
*Dieser Text ist kursiv.*
\*Dieser Text hat Sternchen.\*
*\*Dieser Text hat Sternchen und ist kursiv.\**
:::
:::danger
TODO
https://pandoc.org/MANUAL.html#extension-all_symbols_escapable
:::
### Nonbreaking Space
:::danger
TODO
https://pandoc.org/MANUAL.html#extension-smart
https://pandoc.org/MANUAL.html#extension-all_symbols_escapable
:::
## Alerts
:::danger
TODO
:::
:::
"BlockQuote" : BlockQuote,
## Listen
:::danger
TODO
https://pandoc.org/MANUAL.html#extension-lists_without_preceding_blankline
:::
"BulletList" : BlockBulletList,
### Geordnete Listen
:::danger
TODO
:::
"OrderedList" : BlockOrderedList,
### Aufgabenlisten
:::danger
TODO
https://pandoc.org/MANUAL.html#extension-task_lists
:::
### Beispiellisten
:::danger
TODO
https://pandoc.org/MANUAL.html#numbered-example-lists
:::
### Listen beenden
:::danger
TODO
https://pandoc.org/MANUAL.html#ending-a-list
:::
"DefinitionList": BlockDefinitionList,
## Codeblöcke
:::danger
TODO
:::
"HorizontalRule": BlockHorizontalRule,
## Tabellen
:::danger
TODO
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
## Kommentare
Kommentare können einfach mit [HTML Kommentaren](https://www.w3schools.com/html/html_comments.asp) gemacht werden.
```markdown
Hallo Welt
<!-- Ich bin unsichtbar. Achtung: Es kann zusätzliche Zeilenumbrüche geben. -->
Guten Tag
```
:::success
Hallo Welt
<!-- Ich bin unsichtbar. Achtung: Es kann zusätzliche Zeilenumbrüche geben. -->
Guten Tag
:::
## Divs und Spans
:::danger
TODO
https://pandoc.org/MANUAL.html#divs-and-spans
https://pandoc.org/MANUAL.html#generic-raw-attribute
https://pandoc.org/MANUAL.html#raw-htmltex
:::
"Div" : BlockContainer,
"Span" : InlineContainer,
### Sachen nebeneinander darstellen
:::danger
TODO
https://pandoc.org/MANUAL.html#columns
:::
https://pandoc.org/MANUAL.html#raw-html
https://pandoc.org/MANUAL.html#raw-htmltex
:::
"RawBlock" : BlockRaw,
"RawInline" : InlineRaw,
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
## Abbreviations
Nicht unterstützt.
:::danger
TODO
https://pandoc.org/MANUAL.html#extension-abbreviations
:::
## Line Blocks
:::danger
TODO
https://pandoc.org/MANUAL.html#line-blocks
:::