Markdown Syntax

Grundkenntnisse zur Formatierung

Markdown besteht aus leicht zu lernenden Syntaxen, die das rapide Formatieren eines Textes erlauben. Diese werden im Anschluss erläutert:

Überschriften

Die Erstellung mit Überschriften, welche in HTML mit dem h-tag formatiert werden, erfolgt mit dem Rautezeichen (#). Überschriften kannst Du von h1 bis h6 formatieren:

Die erste Überschrift

Noch eine Überschrift

Abschließend eine weitere Überschrift

Textformatierung

Zur Formatierung von Text verwenden Autoren verschiedene Stile, insbesondere Fett- und Kursivschrift:

Formatierung Markdown-Syntax Beispiel Fett ** ** oder __ __ Fetter Text Kursiv * * oder _ _ Kursiver Text

Zitate

Zitate werden mit dem Symbol größer als (>) begonnen:

Ich bin ein Zitat! Für Zitate innerhalb eines Satzes wird ein einzelnes, rückwärts geneigtes Hochkomma verwendet:

In diesem Satz möchte ich ein Zitat darstellen.

Links

Die Erstellung von Inline-Links erfolgt über eckige Klammern ([]) für den Linktext gefolgt von runden Klammern (()) für die URL:

Für weitere Informationen hier klicken.

Bilder

Das Einbinden von Grafiken ähnelt der Integrierung von Links. Bilder beginnen mit einem Ausrufezeichen (!):

Bildtext

Listen

Listen werden geordnet oder ungeordnet mit einem Bindestrich (-) oder einer Zahl (1.) begonnen.

Ungeordnet:

  • ungeordneter Listenpunkt 1
  • ungeordneter Listenpunkt 2
  • ungeordneter Listenpunkt 3

Geordnet:

  1. geordneter Listenpunkt 1
  2. geordneter Listenpunkt 2
  3. geordneter Listenpunkt 3

Beide Stile können miteinander kombiniert werden:

  1. Titel 1

- Punkt 1 - Punkt 2 2. Titel 2 - Punkt 1 - Punkt 2

Erweiterte Syntaxen für formschöne Texte

Die zuvor genannten Syntaxen wurden von dem Erfinder von Markdown, John Gruber, definiert. Sein Markdown-Prozessor wurde inzwischen um weitere Syntaxen erweitert, die neue Formatierungen ermöglichen. Eine weitergehende Einführung in gibt es hier.

Markdeep ist eine Technologie zum Schreiben von reinen Textdokumenten, die in jedem Webbrowser, ob lokal oder entfernt, gut aussehen. Es unterstützt Diagramme, Kalender, Gleichungen und andere Funktionen als Erweiterungen der Markdown-Syntax.

Tabellen

Tabellen sind wunderbar dazu geeignet, um bestimmte Informationen übersichtlich darzustellen. Sie werden mit Pipes (|) und Bindestrichen (-) formatiert:

| Linke Überschrift | Rechte Überschrift | | ------------------ | ------------------ | | Etwas Text hier | Ein bisschen hier | Mit Doppelpunkten (:) kannst Du die Textausrichtung bestimmen:

| Überschrift 1 | Überschrift 2 | Überschrift 3 | |:--------------|:-------------:|--------------:| | Links | Zentriert | Rechts | Innerhalb von Tabellen kannst Du natürlich andere Syntaxen verwenden, um Deinen Text zu stylen (Fett- und Kursivschrift zum Beispiel).

Fußnoten

Mit Fußnoten hast Du die Möglichkeit, dem Leser Informationen zu geben, ohne den Lesefluss zu stören. Fußnoten sind kleine, hochgestellte Nummerierungen, die hinter einem Wort erscheinen und zum Ende des Dokuments verlinken.

Hier ist ein Text, der weitere Informationen1 voraussetzt. Die erste Syntax kreiert die Verlinkung. Nun musst Du Ihr einen entsprechenden Text zuweisen, den Du unter der Textpassage oder am Ende des Dokuments definierst:


  1. Weitere Informationen hier In Fußnoten kannst Du Links einbauen und Text formatieren. ↩︎