Markdown in zehn Minuten – Schreiben ohne Formatierungschaos
Überschriften, Listen, Links und Hervorhebungen mit ein paar Satzzeichen. Alles, was man braucht, um Beiträge für diese Seite zu schreiben.
Alle Beiträge auf dieser Seite werden in Markdown geschrieben: reiner Text mit einigen wenigen Zeichen für die Formatierung. Das Ergebnis ist lesbar, auch ohne dass es jemand in HTML verwandelt.
Das Wichtigste auf einen Blick
| Sie schreiben | Sie bekommen |
|---|---|
# Titel |
eine Überschrift erster Ordnung |
## Abschnitt |
eine Überschrift zweiter Ordnung |
**fett** |
fett |
*kursiv* |
kursiv |
[Text](https://…) |
einen Link |
- Punkt |
einen Listenpunkt |
1. Punkt |
einen nummerierten Punkt |
> Zitat |
ein eingerücktes Zitat |
Absätze trennt man durch eine Leerzeile. Alles andere ist optional.
Ein Beitrag für diese Seite
Jede Artikeldatei beginnt mit einem kleinen Kopfbereich zwischen zwei Zeilen aus drei Bindestrichen:
---
title: Überschrift des Beitrags
date: 2026-09-08
category: technik
summary: Ein bis zwei Sätze, die unter der Überschrift und in Listen erscheinen.
---
Hier beginnt der eigentliche Text.
Der Dateiname wird zur Adresse: mein-beitrag.md erscheint unter /artikel/mein-beitrag/. Kleinbuchstaben, Bindestriche, keine Umlaute.
Die Kategorie muss eine der fünf Rubriken sein: in-eigener-sache, technik, sicherheit, web oder redaktion.
Häufige Stolpersteine
Zeilenumbruch innerhalb eines Absatzes. Ein einfacher Umbruch im Text erzeugt keinen Umbruch im Ergebnis. Für einen neuen Absatz eine Leerzeile lassen.
Sonderzeichen. Sterne, Unterstriche und Rauten am Zeilenanfang haben Bedeutung. Wer sie wörtlich braucht, setzt einen Backslash davor: \*.
Bilder.  bindet ein Bild ein. Die Beschreibung ist Pflicht, sie wird vorgelesen, wenn das Bild nicht angezeigt werden kann.