Discourse nutzt Markdown als internes Datenformat ( Markdown – Wikipedia ). Markdown ist eine vereinfachte Auszeichnungssprache ähnlich wie HTML für Webseiten. Die Formatierungs-Möglichkeiten sind bewusst auf das Wesentliche beschränkt (z.B. Fett, kursiv, bullet points usw.). Ziel ist die gute Strukturierung, Lesbarkeit und dauerhafte Archivierung eines Textes, ohne Datenverlust und mit maximaler Flexibilität beim Übertragen in andere Systeme.
Im Discourse Editor können Texte wahlweise direkt als Markdown oder in einem grafischen Editor ähnlich einer Textverarbeitung eingegeben werden. Hier die Basis-Syntax von Markdown:
| Element | Markdown Syntax |
|---|---|
| Überschrift (1. bis 3. Ordnung) | # H1 |
## H2 |
|
### H3 |
|
| fett | **bold text** |
| kursiv | *italicized text* |
| Zitat | > blockquote |
| Sortierte Liste | 1. First item |
2. Second item |
|
3. Third item |
|
| Unsortierte Liste | - First item |
- Second item |
|
- Third item |
|
| Quellcode (vor-formatiert) | `code` |
| Horizontale Linie | --- |
| Link | [title](https://www.example.com) |
| Bild |  |
Erweiterte Syntax
Quelle: Markdown Cheat Sheet | Markdown Guide
Dazu gehören z.B. Fussnoten, Tabellen, Definitions-Listen, durchgestrichener Text, Aufgabenlisten, Hervorhebungen, Hoch/Tiefstellung. Für einen Teil der komplexeren Elemente gibt es Buttons oben im Menü des Discourse Editors, Achtung beim Übertragen von Texten in andere Anwendungen: nicht alle Elemente der erweiterten Syntax werden in allen Anwendungen unterstützt.
## Extended Syntax
These elements extend the basic syntax by adding additional features. Not all Markdown applications support these elements.
### Table
| Syntax | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |
### Fenced Code Block
{
„firstName“: „John“,
„lastName“: „Smith“,
„age“: 25
}
### Footnote
Here's a sentence with a footnote. [^1]
[^1]: This is the footnote.
### Heading ID
### My Great Heading {#custom-id}
### Definition List
term
: definition
### Strikethrough
~~The world is flat.~~
### Task List
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media
### Emoji
That is so funny! :joy:
(See also [Copying and Pasting Emoji](https://www.markdownguide.org/extended-syntax/#copying-and-pasting-emoji))
### Highlight
I need to highlight these ==very important words==.
### Subscript
H~2~O
### Superscript
X^2^