Headers (Überschriften)
=======================
Es gibt zwei Möglichkeiten, um Headers (Überschriften) in Markdown zu verwenden. (In diesen Beispielen ist
Überschrift 1 die größte und Überschrift 6 ist die kleinste.)
Sie können Text unterstreichen, um die beiden Top-Level-Header zu erzeugen:
Überschrift 1
=============
Überschrift 2
-------------
Die Zahl der `=` oder `-` Zeichen spielt keine Rolle, es reicht nur mit einem Zeichen zu unterstreichen.
Aber mit mehr Zeichen zu unterstreichen macht Ihren Titel im Klartext besser lesbar.
Sie können auch Hash-Zeichen für alle sechs Ebenen der HTML-Header verwenden:
# Header 1 #
## Header 2 ##
### Header 3 ###
#### Header 4 ####
##### Header 5 #####
###### Header 6 ######
Die schliessenden `#` Zeichen sind optional.
Horizontale Linien
==================
Sie können eine horizontale Linie zeichnen, indem Sie drei oder mehr Bindestriche,
Sternchen oder Unterstriche auf einer eigenen Zeile schreiben:
---
*******
___
Sie können auch Leerzeichen zwischen den Zeichen lassen:
- - - -
All diese Beispiele haben das gleiche Ergebnis.
Listen
======
Einfache Listen
---------------
Eine Aufzählung:
- Sie können ein Minuszeichen für Aufzählungszeichen verwenden
+ Oder ein Pluszeichen
* Oder ein Sternchen
Eine nummerierte Liste:
1. Nummerierte Listen sind einfach
2. Markdown verfolgt die Zahlen für Sie
7. So wird dies Artikel 3 sein.
Eine zweizeilige Liste:
- Diese Liste wird in p-Tags umschlossen
- Es wird also mehr Platz zwischen den Elementen werden
Erweiterte Listen: Schachtelung
-------------------------------
Sie können andere Markdown-Blöcke in einer Liste setzen, nur ein Gedankenstrich und vier Leerzeichen
für jede Verschachtelungsebene. Also zum Beispiel:
1. Listen in einer Liste Artikel:
- Vier Leerzeichen eingerückt.
* Eingerückt acht Leerzeichen.
- Vier Leerzeichen wieder.
2. Mehrere Abschnitte in einem Listen Element:
Es ist am besten für den Einzug der Absätze vier Leerzeichen zu verwenden.
Sie können auch drei verwenden, aber es kann
verwirrend sein, wenn Sie andere Dinge schachteln.
Halten Sie sich an vier.
Wird in der ersten Zeile ein zusätzliches Leerzeichen zum Einrücken vewendet,
dann werden alle Absätze dieses Blockes daran ausgerichtet.
In der Praxis läßt sich das verwenden, um
die gesamte Liste auszurichten.
Dieser Absatz ist immer noch Teil des Listeneintrags, aber es sieht unordentlich aus für den
Menschen. So ist es eine gute Idee, die verschachtelten Absätze manuell ausrichten, wie
wir es mit den ersten beiden taten.
3. Einrückungs in einem Listenelement:
> Skip einer Linie und
> Gedankenstrich
>'s vier Leerzeichen.
4. Vorformatierter Text in einem Listen Artikel:
Direkt eine Linie und Gedankenstrich acht Leerzeichen.
Das sind vier Leerzeichen für die Liste
und vier zum Auslösen des Code-Blocks.
Einrückung
==========
Einfache Einrückung
-------------------
Einrückungen, die eingerückt sind:
> Die Syntax ist auf dem Weg per E-Mail-Programme basieren
> Normalerweise Zitate. Es ist nicht zu schwer-wrap müssen
> Die Absätze in Ihrem Einrückungs, aber es sieht viel schöner aus, wenn Sie es so machen. Hängt davon ab,
wie faul Sie sich fühlen.
Erweiterte Einrückung: Schachtelung
-----------------------------------
Sie können andere Markdown-Blöcke in einer Einrückung setzen, fügen Sie einfach ein `>` gefolgt
von einem Leerzeichen:
Paragraph Pausen in einer Einrückung:
> Der> auf die leeren Zeilen ist optional.
> Fügen Sie es oder nicht; Markdown kümmert sich nicht.
>
> Aber Ihr Klartext sieht besser aus, um
> Menschen, wenn Sie die zusätzlichen `>` include
> Zwischen den Absätzen.
Einrückung innerhalb einer Einrückung:
> Eine Standard Einrückung ist eingerückt
>> Eine verschachtelte Einrückung ist etwas mehr eingerückt
>>>> Können Sie in beliebiger Tiefe schachteln.
Listen in einer Einrückung:
> - Eine Liste mit einer Einrückung
> - Mit a> und Raum vor sich
> * A Unterliste
Vorformatierter Text in einer Einrückung:
> Einrücken fünf Leerzeichen insgesamt. Die erste
> Man ist Teil des Einrückung-Kennung.
Bilder
======
Die Bilder sind genau wie Links, aber sie haben ein Ausrufezeichen davor:
.
Die Wörter in den eckigen Klammern werden als Alt-Text verwendet, der angezeigt wird, wenn der Browser das Bild
nicht darstellen kann. Achten Sie auf sinnvolle Alt-Texte, weil Screen-Reader-Software sie dann für blinde
Nutzer aufbereiten kann.
Genau wie Links, arbeiten Bilder-Link mit Referenzsyntax und Titel:
Diese Seite ist ![Valid XHTML][Häkchen].
[Häkchen]: http://w3.org/Icons/valid-xhtml10
"Was grinst du so?"
**Hinweis:**
Markdown unterstützt derzeit keine kurze Referenz Syntax für Bilder:
Hier ist eine nicht funktionierende Referenz ![Häkchen]
Aber Sie können eine etwas ausführlichere Version des impliziten Verweis Namens verwenden:
So ![Häkchen][] funktioniert es.
Die Referenz-Namen (`gültig Symbol`) werden auch als Alt-Text verwendet.
Inline HTML
===========
Wenn Sie etwas brauchen, was Markdown nicht versteht, können Sie immer auch reiens HTML verwenden:
Durchstreichen Humor ist lustig .
Markdown funktioniert auch innerhalb dieser Block-Level-HTML-Bereiche:
Markdown arbeitet *hier* ohne Probleme.
Block-Level-HTML-Elmente haben ein paar Einschränkungen:
1. Sie müssen vom umgebenden Text mit einem Leerzeichen getrennt werden.
2. Die Anfangs-und End-Tags des äußersten Block-Elements
dürfen nicht eingerückt werden.
3. Markdown funktioniert nicht innerhalb dieser HTML-Blöcke.
Also z.B.:
Markdown können Sie hier nicht verwenden.
Vorformatierter Text
====================
Sie können vorformatierten Text in einen Markdown-Dokument einfügen.
Um einen Code-Block zu erzeugen, verwenden Sie einfach vier Leerzeichen als Einrückung:
printf("Auf Wiedersehen Welt!"); / * sein Abschiedsbrief wurde in C geschrieben * /
Der Text wird in `` und `` Tags eingepackt, und der Browser wird diesen Bereich in einer
nicht-proportionalen Schriftart angezeigen. Die ersten vier Leerzeichen werden entfernt,
aber alle anderen Leerzeichen bleiben erhalten.
Markdown oder HTML wird innerhalb dieser Bereiche nicht ausgeführt, wodurch es eine bequeme Möglichkeit
gibt Beispiele aus der Markdown- oder HTML-Syntax zu zeigen:
Formatierung von Code Bereichen im Text
=======================================
Sie können inline `` Tags mithilfe von Code-Bereichen erzeugen. Das ist eine einfache Möglichkeit
einzelne Wörter oder Wortgruppen im Text als "Programmcode" darzustellen. Verwenden Sie Backticks (Gegenhochkommas),
um einen Code-Bereich zu erzeugen:
Auf deutschen Tastaturen finden Sie die Taste für das Gegenhochkomma oben rechts, links neben der
Backspace(Zurück)-Taste. Drücken und Halten Sie Shift(Umschalt)-Taste und drücken Sie anschliessend
die Gegenhochkomma-Taste. Lassen Sie nun beide Tasten
los und drücken Sie auf die Leerzeichen-Taste. Danach erscheint das Gegenhochkomma.
Die gewünschten Wörter schliessen Sie in Gegenhochkommas ein, wodurch diese Wörter dann wie "Programmcode",
in einer nicht-proportionalen Schrift dargestellt werden.
Innerhalb dieser Bereiche wird Markdown und HTML nicht ausgeführt, d.h. auch Leerzeichen bleiben erhalten:
Beispiel: `I * Liebe * it`
Verwenden Sie nicht den ``-Tag; mit CSS anstelle dessen.