Texte aus Kanzleien, Agenturen oder Word-Dokumenten verlieren in WordPress oft ihre Struktur. Absätze verschwinden, Überschriften verrutschen, die Formatierung wirkt unruhig. Markdown ist eine einfache Lösung, um solche Inhalte klar, lesbar und konsistent darzustellen – unabhängig davon, ob Sie den Classic Editor, Gutenberg oder WPBakery nutzen.
Warum Markdown überzeugt
Markdown ist ein leichtes Textformat, das sich schnell erfassen und einfach pflegen lässt. Eine Raute erzeugt eine Überschrift, zwei Sternchen machen Text fett, zwei Leerzeichen am Zeilenende sorgen für einen Umbruch. Beispiel:
# Über uns
**Elbnetz GmbH**
Wir entwickeln Websites mit WordPress – einfach, klar und effizient.
Dieser Text wird automatisch zu sauberem HTML mit korrekten Überschriften, Absätzen und Hervorhebungen. Markdown eignet sich nicht nur für Rechtstexte wie Impressum oder Datenschutz, sondern auch für Blogartikel, Produktbeschreibungen, FAQ-Bereiche oder technische Dokumentation.
Wenn Sie Markdown im Detail lernen möchten, finden Sie eine ausführliche deutschsprachige Einführung bei markdown.de. Dort werden alle wichtigen Befehle und Formatierungen erklärt – von Überschriften über Listen bis hin zu Tabellen.
So funktioniert die Integration
Ein kleiner PHP-Code ergänzt WordPress um den Shortcode [md]. Dieser nutzt den Parser Parsedown, um Markdown in HTML zu konvertieren. Sie können damit entweder eine Markdown-Datei laden oder Text direkt zwischen [md] und [/md] einfügen. Beide Varianten funktionieren in allen Editoren gleich zuverlässig.
Einrichtung Schritt für Schritt
1. Parsedown installieren
Laden Sie von GitHub die Datei Parsedown.php herunter und kopieren Sie sie in Ihr Child-Theme:
/wp-content/themes/DEIN-CHILD/inc/parsedown-master/Parsedown.php
2. Shortcode hinzufügen
Fügen Sie in der functions.php Ihres Child-Themes folgenden Code ein:
add_shortcode('md', function($atts, $content = null) {
$upload_dir = wp_upload_dir();
$base_dir = trailingslashit($upload_dir['basedir']) . 'texte';
$parsedown_file = get_stylesheet_directory() . '/inc/parsedown-master/Parsedown.php';
if (!class_exists('Parsedown')) {
if (!file_exists($parsedown_file)) {
return 'Fehler: Parsedown.php fehlt unter /inc/parsedown-master/';
}
require_once $parsedown_file;
}
$a = shortcode_atts(['file' => ''], $atts, 'md');
if ($a['file']) {
$base = realpath($base_dir);
$target = realpath($base . '/' . ltrim($a['file'], '/'));
if (!$base || !$target || strpos($target, $base) !== 0 || !is_file($target)) {
return 'Fehler: Ungültiger oder fehlender Markdown-Pfad.';
}
$content = file_get_contents($target);
}
if (trim($content) === '') return '';
if (!preg_match('/ {2,}\n/', $content)) {
$content = preg_replace("/([^\n])\n([^\n])/", "$1 \n$2", $content);
}
$pd = new Parsedown();
$pd->setSafeMode(true);
$html = $pd->text(trim($content));
remove_filter('the_content', 'wpautop');
remove_filter('the_content', 'wptexturize');
return wp_kses_post($html);
});
Verzeichnisstruktur
Erstellen Sie im Upload-Ordner einen Unterordner für Ihre Markdown-Dateien:
wp-content/uploads/texte/
Legen Sie dort beliebige .md-Dateien ab, zum Beispiel ueber-uns.md, agb.md oder faq.md.
Nutzung in allen Editoren
Im Classic Editor oder im Block Editor (Gutenberg) fügen Sie den Shortcode direkt ein:
[md file="ueber-uns.md"]
oder schreiben Sie Markdown direkt zwischen den Shortcodes [md]…[/md]:
[md]
# Über uns
Wir lieben sauberen Code und funktionale Websites.
[/md]
In WPBakery verwenden Sie am besten den Block „Raw HTML“, damit der erzeugte Code unverändert bleibt.
Markdown direkt in WordPress mit einem Plugin
Wenn Sie Markdown lieber direkt in WordPress schreiben möchten, ohne externe Tools zu nutzen, ist das Plugin WP Githuber MD eine gute Wahl.
Es ersetzt den klassischen Editor durch eine übersichtliche Oberfläche mit zwei Ansichten – links der Markdown-Text, rechts die Live-Vorschau.
Überschriften, Listen, Links und Bilder lassen sich per Toolbar einfügen, ohne dass Sie die Syntax auswendig kennen müssen.
Das Plugin funktioniert sowohl mit dem Classic Editor als auch in vielen Page Buildern, speichert Inhalte sicher in der Datenbank und wandelt sie beim Anzeigen automatisch in sauberes HTML um.
Damit eignet es sich ideal für Anwender, die Markdown komfortabel nutzen möchten, ohne technische Einstellungen vornehmen zu müssen.
Fazit
Markdown ist ein Werkzeug, das Struktur schafft und den Pflegeaufwand reduziert. Mit dem Shortcode [md] lassen sich Texte zentral und einheitlich darstellen – egal ob Blogbeitrag, Produktbeschreibung, technische Dokumentation oder Rechtstext. So behalten Sie Kontrolle über Inhalt und Erscheinungsbild, ohne sich mit Editor-Fehlern oder Formatierungsproblemen herumschlagen zu müssen.
Bonus: Markdown ohne Programmierkenntnisse – einfache Tools für den Alltag
Nicht jeder möchte sich mit Code oder Installation beschäftigen, nur um Texte in Markdown zu bringen. Zum Glück gibt es dafür unkomplizierte Online-Dienste, die Word-, PDF- oder Google-Dokumente automatisch umwandeln. So können auch Anwender ohne technische Erfahrung ihre Inhalte schnell und sauber für WordPress vorbereiten.
Word2MD.net
Word2MD.net ist eine der einfachsten Lösungen. Laden Sie einfach Ihr Word-Dokument hoch, und die Website erzeugt daraus den passenden Markdown-Text.
Sie können den fertigen Code direkt kopieren oder als Datei herunterladen. Ideal, wenn Sie Texte aus der Kanzlei, von Kollegen oder aus einem Kundenbriefing übernehmen möchten.
Für einzelne Texte reicht Word2MD.net vollkommen aus. Es ist schnell, kostenlos und benötigt keine Anmeldung.Wer regelmäßig Texte umwandelt, kann zusätzlich auf die Dienste von Aspose oder MarkItDown zurückgreifen.
Aspose Words to Markdown
Der Online-Dienst Aspose Words to Markdown funktioniert ähnlich, unterstützt aber zusätzlich PDF- und OpenOffice-Dateien.
Nach dem Upload können Sie zwischen verschiedenen Exportformaten wählen – darunter Markdown, HTML oder Text.
Praktisch, wenn Ihre Quelldokumente nicht immer im Word-Format vorliegen.
MarkItDown (Online-Demo)
Mit MarkItDown lassen sich Word-, PDF- oder HTML-Dateien direkt im Browser umwandeln.
Nach dem Upload zeigt das Tool sofort den konvertierten Markdown-Text an.
Sie sehen also live, wie der Code später in WordPress aussieht.
Google Docs Add-on „Docs to Markdown“
Wenn Sie ohnehin mit Google Docs arbeiten, können Sie das Add-on Docs to Markdown nutzen.
Es wird über den Menüpunkt „Erweiterungen → Add-ons“ installiert und fügt anschließend eine neue Option hinzu, mit der Sie jeden Google-Text per Klick als Markdown exportieren.