Markdown-Editor – und die Sprache dahinter erklärt

Warum Markdown

Markdown trennt das Schreiben vom Gestalten. Wer tippt, muss keine Menüs öffnen und keine Schaltflächen suchen – ein paar Sonderzeichen genügen. Der Rohtext bleibt dabei lesbar, lässt sich in jedem Editor bearbeiten, mit Versionsverwaltung vergleichen und in beliebige Formate umwandeln.

Genau deshalb hat sich Markdown dort durchgesetzt, wo viel geschrieben und wenig gestaltet wird: in Dokumentationen, Wikis, Tickets, Chat-Nachrichten und Content-Management-Systemen.

Die Befehle im Überblick

Die folgenden Abschnitte zeigen jeden Befehl mit Beispiel.

Überschriften

Rauten am Zeilenanfang, gefolgt von einem Leerzeichen. Die Zahl der Rauten bestimmt die Ebene:

# Hauptüberschrift
## Kapitel
### Abschnitt
#### Unterabschnitt

Alternativ lassen sich die ersten beiden Ebenen durch eine Linie aus Gleichheitszeichen oder Bindestrichen unter dem Text auszeichnen:

Hauptüberschrift
================

Kapitel
-------

Tipp: Pro Dokument nur eine Überschrift der ersten Ebene verwenden und keine Ebene überspringen. Das hilft Screenreadern, Suchmaschinen und automatisch erzeugten Inhaltsverzeichnissen.

Absätze und Zeilenumbrüche

Eine Leerzeile trennt Absätze. Ein einfacher Zeilenumbruch wird dagegen zu einem Leerzeichen zusammengezogen – so bleiben lange Absätze im Rohtext übersichtlich.

Das ist der erste Absatz.
Diese Zeile gehört noch dazu.

Das ist ein neuer Absatz.

Mit zwei Leerzeichen am Ende  
bricht die Zeile um, ohne neuen Absatz.

Hervorhebungen

Das ist **wichtig**, das ist *betont* und das ist ***beides***.
Das hier ist ~~gestrichen~~.

Sternchen und Unterstriche sind gleichwertig. Unterstriche mitten im Wort – etwa in datei_name_neu – werden nicht als Formatierung erkannt, Sternchen dagegen schon.

Listen

Aufzählungen beginnen mit einem Bindestrich, Sternchen oder Plus. Unterpunkte werden eingerückt:

- Angebot schreiben
- Termin abstimmen
  - Vorschlag Dienstag
  - Vorschlag Mittwoch
- Rechnung prüfen

Nummerierte Listen beginnen mit einer Zahl und einem Punkt. Die tatsächlichen Zahlen spielen keine Rolle – nur die erste bestimmt den Startwert:

1. Erster Schritt
2. Zweiter Schritt
3. Dritter Schritt

Aufgabenlisten sind eine Erweiterung aus GitHub Flavored Markdown:

- [x] Raum gebucht
- [ ] Unterlagen verschickt

Links und Bilder

Der sichtbare Text steht in eckigen, die Adresse in runden Klammern. Ein optionaler Titel in Anführungszeichen erscheint beim Überfahren mit der Maus:

[p17-tools.de](https://www.p17-tools.de)
[Kontakt](/kontakt "Zum Kontaktformular")
<https://www.p17.de>

Bilder funktionieren genauso, mit einem Ausrufezeichen davor. Der Text in den eckigen Klammern ist die Bildbeschreibung für Screenreader und Suchmaschinen:

![Logo der p17 GmbH](logo.svg)

Zitate

Ein spitzes Klammerzeichen am Zeilenanfang. Zitate lassen sich verschachteln und dürfen andere Elemente enthalten:

> Das ist ein Zitat.
>
> > Und das ein Zitat im Zitat.

Code

Einzelne Befehle oder Dateinamen stehen zwischen Backticks – das ist das Zeichen links neben der Rücktaste, zusammen mit der Umschalttaste:

Starten Sie mit `npm install`.

Längere Codeabschnitte stehen zwischen drei Backticks. Nach den öffnenden Backticks kann die Sprache angegeben werden, damit viele Programme den Code farbig darstellen:

```js
const netto = brutto / 1.19;

Innerhalb von Code wird nichts formatiert – Sternchen, Rauten und spitze Klammern bleiben, wie sie sind.

## Tabellen

Spalten werden durch senkrechte Striche getrennt, die zweite Zeile trennt den Kopf vom Inhalt. Doppelpunkte in dieser Trennzeile bestimmen die Ausrichtung:

```markdown
| Aufgabe | Wer  | Bis |
|:--------|:----:|----:|
| Angebot | Anna | Fr  |
| Termin  | Tom  | Mi  |

:--- richtet links aus, :---: zentriert, ---: richtet rechts aus. Die Striche müssen nicht bündig stehen – das ist nur für die Lesbarkeit des Rohtexts.

Trennlinie und Sonderzeichen

Drei Bindestriche, Sternchen oder Unterstriche in einer eigenen Zeile ergeben eine horizontale Linie. Soll ein Zeichen mit besonderer Bedeutung als normaler Text erscheinen, steht ein Backslash davor:

---

\*Das ist kein kursiver Text\*
\# Das ist keine Überschrift

Markdown-Varianten

Die Grundbefehle – Überschriften, Hervorhebungen, Listen, Links, Zitate und Code – funktionieren überall gleich. Unterschiede zeigen sich bei Tabellen, Fußnoten und dem Umgang mit HTML. Wer Texte zwischen Systemen austauscht, bleibt deshalb am besten bei CommonMark plus Tabellen.

Markdown im Arbeitsalltag

Viele Werkzeuge, die im Büro ohnehin laufen, verstehen Markdown – oft ohne dass es jemand weiß. In Microsoft Teams lassen sich Nachrichten mit **fett** oder Listen formatieren, Wikis und Ticketsysteme speichern Beschreibungen meist in Markdown, und für Protokolle ist es schneller als jede Textverarbeitung.

Wer Microsoft 365 und Teams im Unternehmen einführt oder betreibt, findet bei der nice-IT GmbH Unterstützung. Für eigene Anwendungen, in denen Inhalte gepflegt und ausgegeben werden, ist die p17 GmbH Ansprechpartner.

Verwandte Werkzeuge

• Textlängen und Lesezeit: Zeichenzähler
• Seitentitel für Google prüfen: Meta-Tag-Editor
• Links für Newsletter und Social Media: UTM-Link-Generator