Markdown: Syntax, Editoren und Anwendung im Überblick

Was ist Markdown?

Markdown ist ein Textformat, das Formatierungen über einfache Zeichen wie #, * und - abbildet. John Gruber hat es 2004 entwickelt, die Syntax entstand gemeinsam mit Aaron Swartz. Das Ziel war von Anfang an: Text soll auch unformatiert gut lesbar sein.

Technisch passiert dabei Folgendes: Du schreibst reinen Text mit Sonderzeichen. Ein Programm – der Parser – übersetzt diese Zeichen anschließend in HTML. Aus # Titel wird <h1>Titel</h1>. Markdown-Dateien tragen die Endung .md oder .markdown und enthalten nichts außer Text. Du kannst sie mit jedem Editor öffnen, sie funktionieren in 20 Jahren noch und du bist an kein Programm gebunden.

Warum Markdown für Webtexte praktisch ist

Der Klassiker unter den Problemen: Du schreibst einen Text in Word, kopierst ihn ins CMS und bekommst wirre Formatierungen, falsche Schriftgrößen und unsichtbare Style-Reste mitgeliefert. Markdown hat dieses Problem nicht, weil es keine versteckten Formatierungen kennt.

Dazu kommen ein paar handfeste Vorteile:

• Struktur statt Optik: Du legst fest, dass etwas eine Überschrift ist – nicht, dass es 18 Punkt und fett aussieht. Für SEO und Barrierefreiheit ist das die richtige Reihenfolge.
• Versionierbar: Weil .md-Dateien reiner Text sind, kannst du sie in Git verwalten und Änderungen zeilenweise nachvollziehen.
• Portabel: Derselbe Text lässt sich in HTML, PDF, Word oder direkt ins CMS überführen.
• Schneller im Schreibfluss: Keine Maus, keine Formatierungsleiste. Du tippst weiter.

Markdown-Syntax: die komplette Übersicht

Die Basis-Syntax kannst du in zehn Minuten lernen. Diese Tabelle deckt alles ab, was du im Alltag brauchst:

Zeilenumbrüche – der häufigste Stolperstein

Ein einfacher Enter erzeugt in Markdown keinen Umbruch. Willst du einen neuen Absatz, lässt du eine komplette Leerzeile. Willst du nur einen Umbruch innerhalb eines Absatzes, setzt du zwei Leerzeichen ans Ende der Zeile. Viele Editoren zeigen diese Leerzeichen nicht an – wenn ein Umbruch also verschwindet, liegt hier fast immer die Ursache.

Tabellen

Tabellen baust du mit Pipes und einer Trennzeile aus Bindestrichen:

| Spalte 1 | Spalte 2 |
|----------|----------|
| Zelle A  | Zelle B  |

Mit :---, :---: und ---: in der Trennzeile richtest du eine Spalte links, zentriert oder rechts aus. Wichtig: Tabellen gehören nicht zum Original-Markdown. Ob sie funktionieren, hängt vom Dialekt ab – dazu gleich mehr.

Was Markdown nicht kann

Unterstreichen ist im Standard nicht vorgesehen, weil Unterstreichungen im Web für Links reserviert sind. Wenn du es brauchst, nutzt du HTML direkt im Markdown-Text: <u>unterstrichen</u>. Das gilt generell – HTML ist in Markdown-Dateien erlaubt und dient als Notausgang für alles, was die Syntax nicht abbildet.

Markdown ist nicht gleich Markdown: CommonMark, GFM und die Folgen

Die Original-Spezifikation von 2004 kennt keine Tabellen, keine Aufgabenlisten und kein Durchgestrichen. Weil das in der Praxis zu wenig war, sind über die Jahre Dialekte entstanden. Diese drei begegnen dir am häufigsten:

• CommonMark: Der Versuch, Markdown eindeutig zu standardisieren. Klärt vor allem Grenzfälle, bei denen sich Parser früher unterschiedlich verhalten haben.
• GitHub Flavored Markdown (GFM): Baut auf CommonMark auf und ergänzt Tabellen, Aufgabenlisten, Durchgestrichen und automatisch erkannte Links. Der De-facto-Standard, an dem sich die meisten Tools orientieren.
• Pandoc Markdown und MultiMarkdown: Erweitern das Format um Fußnoten, Zitationen, Metadaten und mathematische Formeln. Relevant vor allem im wissenschaftlichen Umfeld.

Praktische Konsequenz: Wenn deine Tabelle in einem Tool sauber dargestellt wird und im nächsten als Textwust erscheint, liegt es am Dialekt. Prüfe im Zweifel, ob dein Editor GFM unterstützt – dann bist du auf der sicheren Seite.

Markdown oder HTML – wann was?

Beides beschreibt Struktur, aber auf unterschiedlichem Niveau. Markdown ist auf Fließtext ausgelegt: Überschriften, Absätze, Listen, Links, Bilder. HTML kann darüber hinaus Layouts, Formulare, CSS-Klassen und interaktive Elemente abbilden.

Die Aufteilung in der Praxis ist einfach: Inhalte schreibst du in Markdown, das Layout kommt aus HTML und CSS. Deshalb funktioniert die Kombination so gut – der Text bleibt sauber, die Gestaltung passiert an anderer Stelle. Für einen Blogartikel reicht Markdown vollständig aus. Für eine Landingpage mit mehrspaltigen Bereichen und individuellen Abständen brauchst du HTML.

Was ist eine .md-Datei und wie öffnest du sie?

Eine .md-Datei ist eine reine Textdatei. Du kannst sie mit jedem Editor öffnen, den dein System schon mitbringt – Notepad unter Windows, TextEdit auf dem Mac, nano oder gedit unter Linux. Du siehst dann den Rohtext samt Sonderzeichen.

Angenehmer wird es mit einem Editor, der die Formatierung direkt darstellt. Und wenn du eine .md-Datei in ein Git-Repository legst, rendert GitHub oder GitLab sie automatisch als formatierte Seite – deshalb sind README-Dateien praktisch immer in Markdown geschrieben.

Markdown-Editoren: der aktuelle Stand

Viele Editor-Listen im Netz führen Programme, die längst nicht mehr gepflegt werden. Hier die Tools, die aktuell tatsächlich sinnvoll sind – sortiert nach Einsatzzweck.

Editoren mit Live-Vorschau

• Typora: Zeigt Formatierungen direkt im Schreibfenster an, ohne geteilte Ansicht. Kostenpflichtig über eine einmalige Lizenz, mit 15-tägiger Testphase. Läuft unter Windows, macOS und Linux.
• MarkText: Kostenlos, Open Source, ähnliches Bedienkonzept wie Typora. Die Entwicklung läuft langsam, mittlerweile gibt es aktivere Community-Forks.
• ghostwriter: Schlanker Editor aus dem KDE-Projekt für Linux und Windows. Ablenkungsfreies Schreiben mit Vorschau und Export.
• Zettlr: Auf längere Texte und wissenschaftliches Arbeiten ausgelegt, mit Zitationsverwaltung und Export über Pandoc.

Notiz- und Wissens-Apps

• Obsidian: Speichert alle Notizen als .md-Dateien in einem lokalen Ordner. Seit Februar 2025 ist auch die geschäftliche Nutzung kostenfrei, eine Lizenz ist optional. Stark, wenn du Notizen untereinander verlinkst.
• Joplin: Open Source, synchronisiert verschlüsselt über Nextcloud, Dropbox oder WebDAV. Gute Wahl, wenn du Notizen über mehrere Geräte brauchst und die Daten selbst kontrollieren willst.
• Logseq: Arbeitet blockbasiert und ebenfalls auf lokalen Markdown-Dateien. Passt zu Journal- und Tagesnotizen.

Code-Editoren

Visual Studio Code ist kostenlos und bringt eine Markdown-Vorschau von Haus aus mit (Tastenkürzel <kbd>Strg</kbd> + <kbd>K</kbd>, dann <kbd>V</kbd>). Mit Erweiterungen kommen Linting, Tabellenformatierung und Diagramme dazu. Wenn du sowieso mit Code arbeitest, brauchst du meist kein zusätzliches Programm. Ähnliches gilt für Sublime Text und neuere Editoren wie Zed.

Online-Editoren

StackEdit und Dillinger laufen im Browser, bieten Live-Vorschau und Export nach HTML oder PDF. HedgeDoc ist die Variante für gemeinsames Schreiben in Echtzeit und lässt sich auf einem eigenen Server betreiben – interessant, wenn Dokumente nicht bei einem Drittanbieter liegen sollen.

Diese Tools brauchst du nicht mehr

In älteren Empfehlungslisten stehen regelmäßig Programme, die nicht mehr weiterentwickelt werden. Atom hat GitHub Ende 2022 archiviert. FoldingText und Laverna werden seit Jahren nicht mehr gepflegt, MarkdownPad ebenfalls nicht. Für Markdown funktionieren die Programme teilweise noch, aber ohne Sicherheitsupdates würden wir sie nicht mehr einsetzen.

Markdown in WordPress nutzen

Der Block-Editor von WordPress versteht Markdown-Kürzel direkt beim Tippen. Schreibst du ## und drückst die Leertaste, wird daraus ein H2-Block. Ein - plus Leerzeichen erzeugt eine Liste, > ein Zitat. Das funktioniert ohne Plugin und beschleunigt das Schreiben im Backend deutlich.

Willst du komplette Beiträge in Markdown schreiben und einfügen, gibt es Plugins mit einem eigenen Markdown-Modul – Jetpack bringt eines mit. Der übliche Workflow in Redaktionen sieht so aus: Text im Editor der Wahl schreiben, als Markdown ins CMS übertragen, dort nur noch Bilder und interne Links ergänzen.

Damit dieser Workflow flüssig läuft, sollte das Backend schnell reagieren. Wenn der Editor bei jedem Speichern hängt, liegt das meist nicht am Text, sondern an der Serverleistung. Unser WordPress Hosting ist auf WordPress abgestimmt, inklusive SSH-Zugang und WP-CLI – praktisch, wenn du Inhalte per Skript aus Markdown-Dateien importieren willst.

Markdown und KI-Tools

Wenn du mit ChatGPT, Claude oder Gemini arbeitest, hast du Markdown längst benutzt. Diese Modelle formatieren ihre Antworten standardmäßig in Markdown – die Überschriften, Listen und fetten Textstellen im Chatfenster sind gerenderter Markdown. Kopierst du eine Antwort in einen Texteditor, siehst du die Rauten und Sternchen.

Für dich heißt das zwei Dinge. Erstens: Ein Editor mit Markdown-Vorschau ist die naheliegende Zwischenstation zwischen KI-Ausgabe und CMS, weil die Struktur dabei erhalten bleibt. Zweitens: Wenn du Inhalte so ablegst, dass Maschinen sie gut lesen können, ist Markdown ein guter Ausgangspunkt – es enthält klare Strukturinformationen und keinen Layout-Ballast.

Markdown in HTML umwandeln

Für einmalige Umwandlungen reicht ein Online-Konverter oder die Exportfunktion deines Editors. Für alles Wiederkehrende lohnt sich ein richtiges Werkzeug:

• Pandoc: Kommandozeilen-Tool, das zwischen Markdown, HTML, PDF, DOCX, LaTeX und vielen weiteren Formaten konvertiert. Der Standard, wenn du regelmäßig umwandelst.
• Bibliotheken für dein Projekt: In PHP übernehmen das Parsedown oder league/commonmark, in JavaScript marked oder markdown-it, in Python die markdown-Bibliothek.
• Static Site Generatoren: Hugo, Jekyll, Astro oder Eleventy erzeugen aus einem Ordner voller .md-Dateien eine komplette statische Website. Die Metadaten – Titel, Datum, Kategorie – schreibst du als YAML-Block an den Dateianfang.

Der Vorteil dieser Generatoren: Am Ende stehen fertige HTML-Dateien ohne Datenbank. Das ist schnell, sicher und läuft auf jedem klassischen Webhosting-Paket mit PHP- und SSD-Speicher.

Wo Markdown an Grenzen stößt

Markdown ist für Text gemacht, nicht für Layout. Diese Punkte solltest du kennen, bevor du ein Projekt darauf aufbaust:

• Keine Gestaltung: Schriftgrößen, Farben, Abstände und CSS-Klassen kannst du nicht setzen. Das ist Absicht, aber du musst es wissen.
• Kein komplexes Layout: Mehrspaltige Bereiche, Karten oder Akkordeons brauchen HTML.
• Dialektabhängigkeit: Tabellen, Fußnoten und Aufgabenlisten funktionieren nicht überall gleich.
• Große Tabellen sind mühsam: Ab etwa fünf Spalten wird die Pflege im Rohtext unangenehm. Dann ist HTML die bessere Wahl.

Für Blogartikel, Dokumentationen, README-Dateien und Notizen sind diese Grenzen kein Problem. Für gestaltete Verkaufsseiten schon.

Vom Markdown-Text zur eigenen Website

Ein guter Text braucht am Ende eine Adresse, unter der er erreichbar ist. Der Ablauf ist überschaubar:

1. Domain sichern. Prüfe mit dem Domain-Check, ob dein Wunschname noch frei ist, und wähle die passende Endung dazu.

2. Technische Basis wählen. Für einen WordPress-Blog, in den du deine Markdown-Texte einpflegst, passt WordPress Hosting. Für eine statisch generierte Seite aus .md-Dateien genügt ein Webhosting-Paket. Wenn du gar nicht selbst bauen willst, kommst du mit dem Homepage-Baukasten ohne Code zur fertigen Seite.

3. Sichtbarkeit aufbauen. Sauber strukturierte Inhalte sind die Grundlage – gefunden werden sie dadurch nicht automatisch. Bei den SEO- und SEA-Dienstleistungen von dogado unterstützt dich ein Team dabei, für die passenden Suchbegriffe zu ranken.

Wenn du bei der Wahl unsicher bist, ruf uns an oder schreib uns eine E-Mail. Unser deutschsprachiger Support schaut sich dein Vorhaben an und sagt dir, welche Variante zu deinem Projekt passt.

Häufige Fragen zu Markdown

Was ist Markdown einfach erklärt?

Markdown ist eine Auszeichnungssprache, die Formatierungen über einfache Zeichen abbildet. # erzeugt eine Überschrift, **Text** macht Text fett. Ein Programm wandelt diese Zeichen anschließend in HTML um.

Welches Programm brauche ich für Markdown?

Keins zwingend – jeder Texteditor genügt, du speicherst die Datei nur als .md. Komfortabler wird es mit einem Editor, der die Formatierung direkt anzeigt, zum Beispiel Visual Studio Code (kostenlos), Obsidian (kostenlos) oder Typora (kostenpflichtig).

Wie öffne ich eine .md-Datei?

Mit jedem Texteditor, den dein Betriebssystem mitbringt – Notepad, TextEdit, nano. Du siehst dann den Rohtext. Für die formatierte Ansicht nutzt du einen Markdown-Editor oder legst die Datei in ein Git-Repository, wo sie automatisch gerendert wird.

Warum funktioniert mein Zeilenumbruch in Markdown nicht?

Ein einfacher Enter reicht nicht. Für einen neuen Absatz lässt du eine komplette Leerzeile, für einen Umbruch innerhalb eines Absatzes setzt du zwei Leerzeichen ans Zeilenende.

Unterstützt Markdown Tabellen?

Ja, aber nicht im Original-Standard. Tabellen kamen über Dialekte wie GitHub Flavored Markdown dazu. In den meisten aktuellen Editoren und CMS funktionieren sie, in älteren Parsern nicht.

Ist Markdown besser als Word?

Für Webtexte meistens ja, weil keine versteckten Formatierungen mitkopiert werden und die Struktur sauber bleibt. Für Serienbriefe, Layout-Dokumente oder Texte mit Kommentarfunktion im Team ist Word die passendere Wahl.

Kann ich Markdown in WordPress verwenden?

Ja. Der Block-Editor erkennt Markdown-Kürzel direkt beim Tippen, etwa ## plus Leerzeichen für eine H2. Für komplette Beiträge in Markdown gibt es Plugins mit eigenem Markdown-Modul.