Markdown-Syntax

Listen

Markdown unterstützt Sie bei der Erstellung von unsortierten und sortierten/ nummerierten Listen. Für die Unterscheidung werden jeweils nur andere Eintragskennzeichen verwendet. Das Eintragskennzeichen muss aber immer nach rechts hin mit mindestens einem Leerzeichen oder einem Tab vom Eintragstext abgegrenzt werden. Normalerweise stehen Listen immer am linken Rand. Sie können jedoch bis zu drei Leerzeichen eingerückt werden.

Unsortierte Listen

Bei unsortierten Listen können Sie Eintragskennzeichen das Sternchen (*), das Plus (+) oder der Bindestrich (-) verwenden. Innerhalb einer Liste können Sie die Eintragskennzeichen auch mischen. Der Übersichtlichkeit halber sollten Sie dies aber nicht machen.

Die folgenden Markdown-Beispiele sind, was den daraus erzeugten HTML-Quelltext angeht, identisch.

* Eintrag 1
* Eintrag 2
* Eintrag 3
+ Eintrag 1
+ Eintrag 2
+ Eintrag 3
- Eintrag 1
- Eintrag 2
- Eintrag 3
* Eintrag 1
+ Eintrag 2
- Eintrag 3

Durch alle drei Markdown-Beispiele wird folgender HTML-Quelltext erzeugt.

<ul>
<li>Eintrag 1</li>
<li>Eintrag 2</li>
<li>Eintrag 3</li>
</ul>

Sortierte/ nummerierte Listen

Bei sortierten/ nummerierten Listen wird als Eintragskennzeichen eine Zahl gefolgt von einem Punkt verwendet. Dabei ist es unerheblich, mit welcher Zahl Sie beginnen oder ob Sie für jeden Eintrag die selbe Zahl verwenden. Sie sollten der Übersichtlichkeit halber aber eine richtige Nummerierung verwenden. Auch weil eventuell in Zukunft eine bestimmte Startnummer von Markdown unterstützt wird.

Die folgenden Markdown-Beispiele sind also, was den daraus erzeugten HTML-Quelltext angeht, identisch.

1. Eintrag 1
2. Eintrag 2
3. Eintrag 3
1. Eintrag 1
1. Eintrag 2
1. Eintrag 3
3. Eintrag 1
3. Eintrag 2
3. Eintrag 3

Durch alle drei Markdown-Beispiele wird folgender HTML-Quelltext erzeugt.

<ol>
<li>Eintrag 1</li>
<li>Eintrag 2</li>
<li>Eintrag 3</li>
</ol>

Einrückungen

Sowohl bei unsortierten als auch bei sortierten/ nummerierten Listen können Sie für ein schöneres Textbild den Text von Listeneinträgern umbrechen und einrücken. Das folgende Beispiel zeigt dies exemplarisch.

* Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
  sed diam nonumy eirmod tempor invidunt ut labore et dolore
  magna aliquyam erat, sed diam voluptua.
* At vero eos et accusam et justo duo dolores et ea rebum.
* Stet clita kasd gubergren, no sea takimata sanctus est
  Lorem ipsum dolor sit amet.

Durch das Markdown-Beispiel wird folgender HTML-Quelltext erzeugt.

<ul>
<li>Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore
magna aliquyam erat, sed diam voluptua.</li>
<li>At vero eos et accusam et justo duo dolores et ea rebum.</li>
<li>Stet clita kasd gubergren, no sea takimata sanctus est
Lorem ipsum dolor sit amet.</li>
</ul>

Absätze in Listen

Sowohl bei unsortierten als auch bei sortierten/ nummerierten Listen können Sie die einzelnen Einträge als Absätze definieren. Dazu trennen Sie die einzelnen Einträge durch Leerzeilen voneinander ab. Das folgende Beispiel zeigt dies exemplarisch.

* Eintrag 1

* Eintrag 2

* Eintrag 3

Durch das Markdown-Beispiel wird folgender HTML-Quelltext erzeugt.

<ul>
<li><p>Eintrag 1</p></li>
<li><p>Eintrag 2</p></li>
<li><p>Eintrag 3</p></li>
</ul>

Listeneinträge können auch aus mehreren Absätzen bestehen. Dazu muss ab dem zweiten Absatz innerhab eines Listeneintrags mit vier Leerzeichen eingerückt werden. Dabei muss eigentlich nur die erste Zeile des Folgeabsatzes eingerückt werden. Schöner schaut es allerdings aus, wenn alle Zeilen mit der gleichen Anzahl an Leerzeichen eingerückt werden. Das folgende Beispiel zeigt dies exemplarisch.

*   Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
    sed diam nonumy eirmod tempor invidunt ut labore et dolore
    magna aliquyam erat, sed diam voluptua. At vero eos et
    accusam et justo duo dolores et ea rebum.

    Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
    sed diam nonumy eirmod tempor invidunt ut labore et dolore
    magna aliquyam erat, sed diam voluptua. At vero eos et
    accusam et justo duo dolores et ea rebum.

*   Stet clita kasd gubergren, no sea takimata sanctus est
    Lorem ipsum dolor sit amet.
*   Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
    sed diam nonumy eirmod tempor invidunt ut labore et dolore
    magna aliquyam erat, sed diam voluptua. At vero eos et
    accusam et justo duo dolores et ea rebum.

    Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore
magna aliquyam erat, sed diam voluptua. At vero eos et
accusam et justo duo dolores et ea rebum.

*   Stet clita kasd gubergren, no sea takimata sanctus est
    Lorem ipsum dolor sit amet.

Durch beide Markdown-Beispiele wird folgender HTML-Quelltext erzeugt.

<ul>
<li><p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore
magna aliquyam erat, sed diam voluptua. At vero eos et
accusam et justo duo dolores et ea rebum.</p>

<p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore
magna aliquyam erat, sed diam voluptua. At vero eos et
accusam et justo duo dolores et ea rebum.</p></li>
<li><p>Stet clita kasd gubergren, no sea takimata sanctus est
Lorem ipsum dolor sit amet.</p></li>
</ul>

Zitate innerhalb eines Listeneintrags

Listeneinträge können auch Zitate enthalten. Dazu muss das Zitat innerhab des Listeneintrags mit mindestens zwei Leerzeichen eingerückt werden. Dabei muss eigentlich nur die erste Zeile des Zitats eingerückt werden. Schöner schaut es allerdings aus, wenn alle Zeilen mit der gleichen Anzahl an Leerzeichen eingerückt werden. Das folgende Beispiel zeigt dies exemplarisch.

* Eintrag 1

  > Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
  > sed diam nonumy eirmod tempor invidunt ut labore et dolore
  > magna aliquyam erat, sed diam voluptua. At vero eos et
  > accusam et justo duo dolores et ea rebum.

* Stet clita kasd gubergren, no sea takimata sanctus est
  Lorem ipsum dolor sit amet.
* Eintrag 1

  > Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
> sed diam nonumy eirmod tempor invidunt ut labore et dolore
> magna aliquyam erat, sed diam voluptua. At vero eos et
> accusam et justo duo dolores et ea rebum.

* Stet clita kasd gubergren, no sea takimata sanctus est
  Lorem ipsum dolor sit amet.

Durch beide Markdown-Beispiele wird folgender HTML-Quelltext erzeugt.

<ul>
<li><p>Eintrag 1</p>

<blockquote>
  <p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore
magna aliquyam erat, sed diam voluptua. At vero eos et
accusam et justo duo dolores et ea rebum.</p>
</blockquote></li>
<li><p>Stet clita kasd gubergren, no sea takimata sanctus est
Lorem ipsum dolor sit amet.</p></li>
</ul>

Quelltext innerhalb eines Listeneintrags

Listeneinträge können auch Quelltext enthalten. Dazu muss der Quelltext innerhab des Listeneintrags mit vier Leerzeichen oder zwei Tabs eingerückt werden. Das folgende Beispiel zeigt dies exemplarisch.

* Eintrag 1

        <strong>HTML-Code</strong>

* Eintrag 2

Durch das Markdown-Beispiel wird folgender HTML-Quelltext erzeugt.

<ul>
<li><p>Eintrag 1</p>

<pre><code>&lt;strong&gt;HTML-Code&lt;/strong&gt;
</code></pre></li>
<li><p>Eintrag 2</p></li>
</ul>

Unbeabsichtigte Listen

Es kann auch vorkommen, dass man unbeabsichtigt eine Liste erstellt. Dies kann vorkommen, wenn man am Zeilenanfang eine beliebige Zahl hat, der ein Punkt folgt - so weie es das folgende Beispiel zeigt.

2015. Das ist Text

Dieses Markdown-Beispiel würde normalerweise den folgenden HTML-Quelltext erzeugen.

<ol>
<li>Das ist Text</li>
</ol>

Wenn Sie an dieser Stelle keine Liste automatisch erzeugen lassen möchten, dann müssen Sie dem Punkt nach der Zahl ein \-Zeichen (Backslash) voranstellen. Das folgende Beispiel zeigt dies.

2015\. Das ist Text

Durch das Markdown-Beispiel wird folgender HTML-Quelltext erzeugt.

<p>2015. Das ist Text</p>