Markdown-Spickzettel: Alle Befehle auf einen Blick (deutsch)

Markdown lernt man am besten durch Ausprobieren. Damit Sie nicht lange suchen müssen, finden Sie hier alle Grundelemente gebündelt. Tipp: Halten Sie diesen Spickzettel offen und tippen Sie die Beispiele direkt in das linke Feld des Konverters. So sehen Sie sofort, was jeder Befehl bewirkt.

Der große Vorteil von Markdown liegt darin, dass die meisten Befehle aus Zeichen bestehen, die Sie sich leicht merken können, weil sie zum gewünschten Ergebnis passen. Eine Raute sieht aus wie eine Markierung am Zeilenanfang und steht für eine Überschrift. Ein Bindestrich vor einem Wort erinnert an einen Aufzählungspunkt. Sternchen umschließen ein Wort, um es hervorzuheben. Wer diese Logik einmal verinnerlicht hat, schreibt Markdown bald flüssig, ohne nachzuschlagen. Bis dahin dient dieser Spickzettel als verlässliche Stütze. Drucken Sie ihn aus oder legen Sie ein Lesezeichen an, dann haben Sie alle Befehle jederzeit griffbereit.

Tabelle 1: Text, Überschriften und Listen

Ein paar Hinweise zu dieser ersten Tabelle: Überschriften gibt es in sechs Ebenen, von einer Raute bis zu sechs Rauten. Mehr Ebenen sind selten nötig und werden von manchen Systemen nicht mehr als Überschrift dargestellt. Bei Aufzählungen ist es gleichgültig, ob Sie Bindestrich, Stern oder Plus verwenden, das Ergebnis ist immer eine Liste mit Punkten. Nummerierte Listen erkennen die richtige Reihenfolge übrigens automatisch: Selbst wenn Sie jede Zeile mit einer Eins beginnen, zählt das Zielsystem korrekt hoch. Task-Listen mit Kästchen gehören zu GitHub Flavored Markdown und sind besonders in Projektlisten und Aufgabenübersichten beliebt.

Tabelle 2: Links, Bilder, Code und mehr

Auch hier lohnen sich ein paar Erläuterungen. Bei Links steht in den eckigen Klammern der sichtbare Text, in den runden Klammern die Zieladresse. Bilder funktionieren fast genauso, nur mit einem Ausrufezeichen davor, und der Text in den eckigen Klammern dient als Alternativtext für Screenreader und für den Fall, dass das Bild nicht lädt. Zitate beginnen mit einem Größer-als-Zeichen und werden vom Zielsystem meist eingerückt und farblich abgesetzt dargestellt. Eine Trennlinie aus drei Bindestrichen in einer eigenen Zeile erzeugt eine waagerechte Linie, die Abschnitte optisch teilt. Durchgestrichener Text und Tabellen gehören wieder zu den GFM-Erweiterungen und werden von den meisten modernen Werkzeugen unterstützt.

Code-Block mit Sprachangabe

Ein eingezäunter Code-Block beginnt und endet mit drei Backticks. Direkt nach den ersten Backticks geben Sie die Sprache an, damit die Syntaxhervorhebung greift:

```js
function gruss(name) {
  return "Hallo " + name;
}
```

Die Sprachangabe nach den Backticks ist optional, aber empfehlenswert. Sie sorgt dafür, dass ein Codebeispiel im Zielsystem farblich hervorgehoben wird, sodass Schlüsselwörter, Zeichenketten und Kommentare leicht zu unterscheiden sind. Gängige Angaben sind js für JavaScript, py oder python für Python, html, css oder bash für die Kommandozeile. Lassen Sie die Sprache weg, wird der Block trotzdem als Code dargestellt, nur eben ohne farbliche Unterscheidung. Innerhalb eines Code-Blocks deutet Markdown übrigens keine Sonderzeichen mehr, das heißt Sternchen und Rauten bleiben genau so stehen, wie Sie sie tippen.

GFM-Tabelle im Detail

Tabellen gehören zu GitHub Flavored Markdown. Die erste Zeile ist die Kopfzeile, darunter folgt eine Trennzeile aus Bindestrichen, dann die Datenzeilen:

| Spalte A | Spalte B |
| -------- | -------- |
| Wert 1   | Wert 2   |
| Wert 3   | Wert 4   |

Eine ausführliche Anleitung mit Ausrichtung der Spalten finden Sie im Ratgeber Markdown-Tabelle erstellen.

Die senkrechten Striche müssen nicht exakt untereinander stehen, das Zielsystem richtet die Spalten beim Darstellen automatisch aus. Trotzdem lohnt es sich, im Quelltext mit ein paar Leerzeichen für saubere Spalten zu sorgen, weil die Tabelle dann auch roh gut lesbar bleibt, ganz im Geiste von Markdown. Über die Trennzeile lässt sich zusätzlich die Ausrichtung steuern: Ein Doppelpunkt rechts vom Bindestrich richtet die Spalte rechtsbündig aus, einer auf beiden Seiten zentriert sie. Wer das nicht angibt, erhält die Standardausrichtung nach links. Verschachtelte Tabellen, also Tabellen in Tabellen, sieht Markdown nicht vor, dafür müsste man auf eingebettetes HTML ausweichen.

Sonderzeichen escapen

Manchmal soll ein Zeichen sichtbar bleiben, das Markdown sonst als Befehl deutet. Dann stellen Sie ihm einen Rückwärtsstrich voran. So schreiben Sie etwa \*kein Kursiv\*, um buchstäblich Sternchen anzuzeigen, statt den Text kursiv zu setzen. Das funktioniert für die typischen Sonderzeichen wie Sternchen, Unterstrich, Raute, eckige Klammern und Backtick.

Das Escapen brauchen Sie seltener, als man denkt, denn in vielen Fällen erkennt Markdown von selbst, dass ein Zeichen nicht als Befehl gemeint ist. Ein Sternchen mitten in einer Rechenaufgabe etwa bleibt meist unangetastet. Sobald es aber zu unerwünschter Formatierung kommt, ist der Rückwärtsstrich die zuverlässige Lösung. Wer ganze Passagen wörtlich anzeigen möchte, etwa Beispielcode mit vielen Sonderzeichen, nutzt besser gleich einen Code-Block oder Inline-Code. Dort wird der gesamte Inhalt unverändert dargestellt, ohne dass Sie jedes einzelne Zeichen escapen müssen.

Direkt ausprobieren

Theorie ist gut, Ausprobieren ist besser. Öffnen Sie den Konverter, fügen Sie eines der Beispiele von oben ein und beobachten Sie die Live-Vorschau. So prägen sich die Befehle am schnellsten ein. Wenn Sie zuerst die Grundlagen verstehen möchten, hilft der Ratgeber Was ist Markdown.

Eine bewährte Lernmethode ist, mit einem echten Text zu beginnen, den Sie ohnehin schreiben müssen, etwa einer kurzen Anleitung oder einer Liste mit Aufgaben. Gliedern Sie ihn mit Überschriften, setzen Sie wichtige Begriffe fett und fassen Sie Punkte in einer Aufzählung zusammen. Sie werden merken, dass die Befehle nach kurzer Zeit von selbst in den Schreibfluss übergehen, weil sie so nah am natürlichen Tippen liegen. Wenn Sie dann eine Tabelle oder einen Code-Block brauchen, schlagen Sie die Schreibweise hier nach. Genau dafür ist ein Spickzettel da: nicht zum Auswendiglernen, sondern zum schnellen Nachschlagen im richtigen Moment.

Markdown ist absichtlich klein gehalten. Es gibt bewusst nicht für jede denkbare Formatierung einen eigenen Befehl, sondern nur für die häufigsten. Das hält die Sprache übersichtlich und sorgt dafür, dass dieselbe Datei in unterschiedlichen Programmen ähnlich aussieht. Alles, was darüber hinausgeht, lässt sich bei Bedarf mit eingebettetem HTML ergänzen, denn Markdown erlaubt rohes HTML mitten im Text. Für die allermeisten Texte werden Sie das aber gar nicht brauchen. Die Befehle aus den beiden Tabellen oben decken den Alltag vollständig ab.

Häufige Fragen