Was ist Markdown, und wie liest man eine .md-Datei?

Jemand hat Ihnen eine Datei mit der Endung .md geschickt, oder Sie sehen einen Text voller Sternchen, Rautezeichen und eckiger Klammern: **so hier**, # so dort. Auf den ersten Blick wirkt das kaputt. Es ist nicht kaputt, sondern formatiert – und diese Schreibweise heißt Markdown.

Die Idee dahinter ist schlicht. Statt zum Formatieren auf Schaltflächen zu klicken, schreiben Sie die Form mit einer Handvoll Zeichen in den Text hinein. Ein Wort zwischen Sternchen wird fett, eine Zeile mit Rautezeichen am Anfang wird zur Überschrift. Ein Programm, das die Zeichen versteht, macht daraus ein sauberes Dokument; ein Programm, das sie nicht versteht, zeigt trotzdem lesbaren Text, denn versteckt ist darin nichts.

Wie öffnet man eine .md-Datei?

Eine Markdown-Datei enthält nichts als gewöhnlichen Fließtext, also kann jedes Schreibprogramm sie öffnen. Starten Sie das Programm, wählen Sie im Menü Datei den Punkt Öffnen und stellen Sie das Feld für den Dateityp in der Ecke des Fensters auf "Alle Dateien" – solange dort "Textdokumente" steht, taucht Ihre .md-Datei in der Liste gar nicht auf. Sie sehen dann die vollständige Datei samt aller Zeichen.

Um sie gesetzt statt roh zu sehen, gibt es zwei Wege. Sie öffnen sie in einer Anwendung, die Markdown versteht: Viele Notiz-Apps, Code-Editoren und Repository-Seiten stellen den Text sofort beim Laden dar. Oder Sie wandeln den Text in HTML um und öffnen das Ergebnis im Browser – das ist der praktischere Weg, wenn Sie das Dokument weitergeben oder in eine Webseite einsetzen wollen.

Falls Sie die Endung überhaupt nicht sehen – der Dateiname endet auf dem Bildschirm nicht auf .md –, setzen Sie im Windows-Explorer unter der Registerkarte Ansicht den Haken bei "Dateinamenerweiterungen". Die Endung zu sehen ist der schnellste Weg, um zu erkennen, zu welchem Programm eine Datei gehört.

Die Zeichen, die Ihnen wirklich begegnen

Sie müssen nicht das ganze Markdown lernen; fast alles Alltägliche läuft über die folgenden Zeichen. Die Tabelle einmal durchzusehen genügt, um jeden Text zu entschlüsseln, der bei Ihnen landet.

Achten Sie auf eine Kleinigkeit: Die meisten dieser Zeichen stehen ganz am Zeilenanfang, und danach folgt ein Leerzeichen. Lassen Sie es zwischen Rautezeichen und Überschriftentext weg, bleibt die Zeile genau so stehen, wie Sie sie getippt haben.

Wo Ihnen Markdown begegnet

Weil Markdown seine Form im Text selbst mitführt, kann diese Form unterwegs nicht verloren gehen. Deshalb wird es überall dort bevorzugt, wo Geschriebenes von Hand zu Hand geht.

Am häufigsten trifft man es in Software-Repositorien: Die README-Datei, die ein Projekt vorstellt, ist praktisch immer Markdown. Daneben verwenden Notiz-Apps, Team-Wikis, Foren, Chat-Anwendungen und Blog-Systeme dieselbe Schreibweise. Auch die Sternchen in Texten, die Sie aus einem KI-Chat kopieren, sind genau das.

Gegenüber einem Textverarbeitungsprogramm besteht der Unterschied darin: In einem Word-Dokument liegt die Formatierung an einer Stelle, die Sie nicht sehen, und das öffnende Programm muss sie verstehen. In Markdown steht die Form offen vor Ihnen. Der Preis dafür ist, dass aufwendige Layouts – mehrere Spalten, Fußnoten, Seitenzahlen – in Markdown schlicht nicht vorkommen; es wurde für kurze, flache Dokumente entworfen.

Den Text in HTML umwandeln

Soll der Text auf eine Webseite, in ein Redaktionssystem oder in den Rumpf einer E-Mail, liegt ein Übersetzungsschritt dazwischen: HTML. Fügen Sie den Text in das Werkzeug Markdown in HTML ein, und aus Überschriften, Listen und Links werden die passenden Auszeichnungen.

Sie wählen zwischen zwei Ausgaben. Die Rumpfausgabe liefert nur die Inhaltsauszeichnungen – das ist das Richtige, wenn Sie in eine bestehende Vorlage einfügen. Die Ausgabe als vollständige Seite erzeugt eine lauffähige Datei, die ein Browser von allein öffnet.

Der Umfang des Werkzeugs deckt den Alltagskern ab: Überschriften, fett, kursiv, Listen, Zitate, Links und Code. Tabellen, Bilder und verschachtelte Listen liegen außerhalb und kommen als reiner Text heraus, statt stillschweigend zu verschwinden. Enthält Ihr Dokument so etwas, sehen Sie das Ergebnis durch und ergänzen diese Stellen von Hand.

Tabellen: der Standard und seine Dialekte

Die Kerndefinition von Markdown kennt überhaupt keine Tabellen. Sie kamen später über Erweiterungen einzelner Plattformen hinzu – deshalb wird dieselbe Tabelle an einer Stelle sauber dargestellt und an einer anderen Zeile für Zeile als reiner Text ausgegeben. Prüfen Sie also vorher, wo Sie veröffentlichen wollen.

Die Schreibweise baut Spalten aus senkrechten Strichen und verlangt direkt unter der Kopfzeile eine Trennzeile. Von Hand wird das nach wenigen Zeilen mühsam, und die Ausrichtung verrutscht schnell.

Liegen Ihre Daten schon als Tabelle vor, gibt es einen kürzeren Weg: Speichern Sie sie als CSV und schicken Sie sie durch das Werkzeug CSV in Markdown-Tabelle. Das Ergebnis fügen Sie direkt in eine README- oder Wiki-Seite ein; weil die Zellen auf Spaltenbreite aufgefüllt werden, bleibt es sogar ungesetzt lesbar.

Vier Fehler, die immer wieder passieren

Die Zeichen von Markdown sind einfach, deshalb häufen sich die Fehler an denselben wenigen Stellen. Wenn ein Text nicht so aussieht wie erwartet, prüfen Sie zuerst diese Punkte.

• Das fehlende Leerzeichen: Zwischen Rautezeichen und Überschriftentext sowie zwischen Bindestrich und Aufzählungstext gehört ein Leerzeichen. "#Überschrift" ist keine Überschrift, "# Überschrift" schon.
• Zusammenlaufende Zeilen: Zwei untereinander getippte Zeilen gelten in den meisten Umgebungen als ein einziger Absatz. Wollen Sie getrennte Absätze, lassen Sie eine Leerzeile dazwischen.
• Wenn ein Sternchen wirklich ein Sternchen ist: Ein Sternchen als Fußnotenzeichen oder in einer Preisliste wird leicht für Formatierung gehalten. Setzen Sie einen umgekehrten Schrägstrich davor (\*), dann bleibt es stehen.
• Bild und Link verwechseln: Eine Schreibweise, die mit einer eckigen Klammer beginnt, ist ein Link; mit einem Ausrufezeichen davor wird ein Bild daraus. Wer das Ausrufezeichen vergisst, bekommt statt des Bildes einen Link auf dessen Adresse.

Häufige Fragen

Wofür wird Markdown verwendet?

Es ist eine schlichte Schreibweise, bei der die Form mit wenigen Zeichen im Text selbst steht. Ein Wort zwischen Sternchen wird fett, eine Zeile mit Rautezeichen wird zur Überschrift. Weil die Datei reiner Text ist, öffnet sie sich überall, und die Form geht unterwegs nicht verloren.

Wie öffne ich eine .md-Datei?

Wählen Sie im Schreibprogramm unter Datei den Punkt Öffnen und stellen Sie den Dateityp auf "Alle Dateien"; die Datei enthält nur Fließtext. Um sie gesetzt zu sehen, öffnen Sie sie in einer Anwendung, die Markdown versteht, oder wandeln den Text in HTML um und betrachten ihn im Browser.

Wie wandle ich Markdown in HTML um?

Fügen Sie den Text in das Werkzeug Markdown in HTML ein; Überschriften, Listen und Links werden zu Auszeichnungen. Für das Einfügen in eine bestehende Vorlage nehmen Sie die Rumpfausgabe, für eine eigenständig lauffähige Datei die vollständige Seite.

Kann ich in Markdown Tabellen schreiben?

In der Kerndefinition nicht; Tabellen stammen aus Erweiterungen einzelner Plattformen und werden deshalb nicht überall gleich dargestellt. Liegen Ihre Daten schon tabellarisch vor, ist der kürzeste Weg, sie als CSV zu speichern und das Werkzeug CSV in Markdown-Tabelle zu nutzen.

Was ist der Unterschied zwischen Markdown und Word?

In Word steckt die Formatierung an einer für Sie unsichtbaren Stelle; in Markdown steht sie offen im Text. Markdown lässt sich besser weitergeben, unterstützt dafür aber keine aufwendigen Layouts wie mehrere Spalten, Fußnoten oder Seitenzahlen.

Zuletzt aktualisiert: 27. August 2026