Kopier-Beispiele (Code-Snippets) zum Einbinden von Bildern ========================================================== Ein Bild links in Originalgrösse (Markdown-Syntax): ![Orchidee](data/help/Orchidee_klein.jpg "Bild") Ein Bild rechts in vorgegebener Grösse (hier: 150 Pixel), welches von Text umflossen wird: Orchidee Ein Bild links in vorgegebener Grösse (hier: 150 Pixel), welches von Text umflossen wird: Orchidee Detailierte Erklärung zu Bildern, siehe weiter unten. Markdown Syntax-Leitfaden ========================= Dies ist eine Übersicht von Markdown. Für weitere Informationen, besuchen Sie die [Markdown Website]. [Markdown Website]: http://daringfireball.net/projects/markdown/ Kursiv und fett =============== *Dies ist kursiv*, und so _sieht es aus_. **Dies ist fett**, und so ist __sieht es aus__. Sie können ***kursiv und fett zusammen*** benutzen, wenn Sie ___es brauchen___. Links ===== Einfache Links -------------- Es gibt drei Möglichkeiten, um Links zu schreiben. Jeder ist einfacher zu lesen als der andere: Hier ist ein Inline-Link, zu [Google](http://www.google.com/). Hier ist ein Referenz-Link zu [Google] [1]. Hier ist ein sehr lesbarer Link, zu [Yahoo!]. [1]: http://www.google.com/ [Yahoo!]: Http://www.yahoo.com/ Die Link-Definitionen können an beliebiger Stelle im Dokument stehen - vor oder nach der Stelle, wo sie verwendet werden. Die Link-Definitions-Namen (`1` und `Yahoo!`) können aus jeder eindeutigen Zeichenfolge bestehen, auch mit Groß- oder/und Kleinschreibung; `[Yahoo!]` ist das gleiche wie `[YAHOO!]`. Erweiterte Links: Title-Attribute --------------------------------- Sie können auch ein `title`-Attribut für einen Link verwenden, der angezeigt wird, wenn der Benutzer den Mauszeiger auf den Link stellt. Title-Attribute sind hilfreich, wenn Ihre Link-Texte nicht aussagekräftig genug sind, um den Benutzer einen Hinweis zu geben, welche Funktion oder Information sich hinter dem Link verbirgt. (In Referenz-Links können Sie optional Klammern für den Link Titel, anstelle von Anführungszeichen verwenden.) Hier ist ein [schlecht benannter Link](http://www.google.com/ "Google"). Schreiben Sie nie "[hier klicken] [^ 2]". Trust [me]. [^ 2]: http://www.w3.org/QA/Tips/noClickHere (Beratung gegen den Satz "Hier klicken") [Me]: http://www.attacklab.net/ "Attacklab" Erweiterte Links: reine URLs ---------------------------- Sie können reine URLs nutzen, indem Sie sie in spitze Klammern schreiben: Meine Website ist unter zu finden. Wenn Sie dieses Format für E-Mail-Adressen verwenden, wird Showdown die Adresse kodieren, damit es für Spammer schwieriger wird diese auszuspähen. Probieren Sie es aus und schauen Sie in das *HTML-Ausgabe-Fenster*, um das Ergebnis zu sehen: Menschen können das lesen, aber die meisten Spam-Ernte-Roboter nicht: 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: ![Valid XHTML](http://w3.org/Icons/valid-xhtml10). 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:

    
       Sie würden es hassen, wenn es nicht in einem
       Code-Block verpackt wäre.
    




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.