Was ist eine .md-Datei? Einfach erklärt

Eine .md-Datei ist ein gewöhnliches Textdokument, geschrieben in einem Stil namens Markdown. Die Zeichen darin, etwa #, **, - und |, sind Anweisungen dafür, wie der Text aussehen soll: Diese Zeile ist eine Überschrift, dieses Wort ist fett, diese Zeilen sind eine Liste. Eine App, die Markdown versteht, blendet die Zeichen aus und zeigt die Formatierung. Eine App, die es nicht versteht, etwa TextEdit, zeigt dir die Zeichen selbst.

Markdown in einem Absatz

Die meisten Dokumente, die du kennst, etwa Word-Dateien und PDFs, speichern ihre Formatierung in einer verborgenen Schicht, die du nie siehst. Markdown macht es umgekehrt: Die Formatierung steht im Text selbst, mit gewöhnlichen Tastaturzeichen. Die Datei ist nur Text, also kann jeder Computer sie öffnen, sie braucht fast keinen Platz und ist auch in dreißig Jahren noch lesbar. Der Preis: Du brauchst eine App, die die Zeichen liest und in Formatierung verwandelt, sonst siehst du sie roh.

Wer es erfunden hat und warum

Markdown stammt von John Gruber, dem Autor des Blogs Daring Fireball, und erschien 2004, mit viel Hilfe des Programmierers Aaron Swartz. Gruber wollte fürs Web schreiben, ohne HTML zu tippen, und stellte eine Regel über alle anderen: Ein Markdown-Dokument soll so, wie es ist, als reiner Text lesbar sein, ohne auszusehen, als wäre es mit Formatierungsbefehlen übersät.

Deshalb wurden die Zeichen aus Gewohnheiten übernommen, die es in reinen Text-E-Mails schon gab, etwa Sternchen um ein Wort zur Betonung. Darum ist eine rohe .md-Datei bei allem Durcheinander noch weitgehend lesbar.

Andere haben später ergänzt, was dem Original fehlte. Die heute am weitesten verbreitete Variante ist GitHub Flavored Markdown mit Tabellen, Checklisten und Durchstreichung. Wer heute „Markdown“ sagt, meint meist diese.

Warum KI-Tools in Markdown schreiben

Wenn ChatGPT, Claude, Gemini oder Copilot dir antwortet, ist der Text meist Markdown. Du merkst es selten, weil das Chatfenster die Zeichen in Überschriften, Fettdruck und Tabellen verwandelt, bevor du sie siehst. Das Format passt gut zu ihnen: Es ist kompakt, übersteht das Kopieren zwischen Apps und ist in den technischen Texten üblich, aus denen diese Tools gelernt haben.

Schwierig wird es, wenn die Antwort den Chat verlässt. Bitte um „eine Datei“, und du bekommst eine .md: denselben Text samt Zeichen, und nichts wandelt sie um. Kopiere eine Antwort in eine App, die Markdown nicht versteht, und die Sternchen kommen mit.

Was die Zeichen bedeuten

Diese begegnen dir in fast jedem Dokument, das eine KI geschrieben hat.

Das steht in der Datei	Das bedeutet es
`# Titel`	Die Hauptüberschrift
`## Abschnitt`, `### Unterabschnitt`	Kleinere Überschriften: je mehr `#`, desto kleiner
`wichtig`	Fett: wichtig
`Hinweis` oder `_Hinweis_`	Kursiv: Hinweis
`- Punkt` oder `* Punkt`	Eine Aufzählung
`1. Punkt`	Eine nummerierte Liste
`- [ ] Aufgabe` und `- [x] erledigt`	Eine Checkliste: ein leeres und ein abgehaktes Kästchen
`[der Bericht](https://example.com)`	Ein Link: die Wörter in eckigen, die Adresse in runden Klammern
`> zitierter Text`	Ein Zitat, eingerückt dargestellt
`Code`	Ein Fachbegriff oder ein Stück Code in Schreibmaschinenschrift
Drei Backticks in einer eigenen Zeile	Anfang oder Ende eines Codeblocks
Zeilen mit Wörtern, getrennt durch senkrechte Striche	Eine Tabelle (siehe unten)

Tabellen sehen roh am abschreckendsten aus, deshalb hier ein Beispiel:

| Artikel | Preis |
| ------- | ----- |
| Kaffee  | 3 €   |
| Kuchen  | 4 €   |

Die erste Zeile ist die Kopfzeile, die Zeile aus Strichen trennt sie vom Rest, und jede weitere Zeile ist eine Tabellenzeile. Die senkrechten Striche markieren, wo eine Spalte endet und die nächste beginnt. Richtig dargestellt ist das eine kleine, gewöhnliche Tabelle mit zwei Spalten und zwei Zeilen.

Ein paar weitere tauchen gelegentlich auf: ~~Text~~ für Durchgestrichenes, --- in einer eigenen Zeile für eine Trennlinie und ![Beschreibung](bild.png) für ein Bild. Das deckt fast alles ab.

Warum dein Mac die Zeichen zeigt

macOS hat keinen eingebauten Markdown-Leser. Für das System ist eine .md-Datei reiner Text, also öffnet ein Doppelklick die App, die für reinen Text zuständig ist, meist TextEdit, oder Xcode, wenn Apples Entwicklerwerkzeuge installiert sind. Beide zeigen genau, was in der Datei steht, samt Zeichen. Die Leertaste im Finder tut dasselbe, solange keine App eine Markdown-Vorschau hinzugefügt hat. Die Datei ist in Ordnung; der Mac weiß nur nicht, wie er sie darstellen soll.

Wie du sie richtig öffnest

Einmalig, ohne etwas zu installieren: In TextEdit öffnen und um die Zeichen herumlesen. Bei einer kurzen Notiz erträglich, bei einer langen Tabelle eine Qual.
In der Cloud: Google Docs öffnet eine .md-Datei, sobald du sie in Google Drive hochgeladen hast. Das funktioniert, bedeutet aber, die Datei irgendwohin hochzuladen, und das will bei einem privaten Dokument überlegt sein.
In einem Code-Editor: VS Code zeigt mit ⇧⌘V eine formatierte Vorschau. Funktioniert, ist aber ein Werkzeug für Programmierer und sieht auch so aus.
In einer Markdown-App: Hem ist eine kostenlose Open-Source-App für den Mac, die genau dafür gemacht ist. Beim ersten Start bietet sie an, die App für .md-Dateien zu werden; danach zeigt ein Doppelklick eine formatierte Seite und die Leertaste im Finder eine formatierte Vorschau. Die Datei bleibt auf deinem Mac. Hem gibt es nur für den Mac.

Eine .md-Datei, geöffnet in Hem: Die Zeichen sind verschwunden, der Bericht zeigt eine Überschrift, eine Tabelle, eine Liste und nummerierte Schritte.

Stammt die Datei aus einem KI-Chat, geht es weiter mit ChatGPT hat mir eine .md-Datei gegeben.

Wie du sie bearbeitest

Jeder Texteditor kann eine .md-Datei ändern, denn sie ist nur Text. Der Haken: Du bearbeitest die Zeichen. Um ein Wort fett zu machen, tippst du zwei Sternchen auf jede Seite und brauchst eine Vorschau, um das Ergebnis zu prüfen.

Willst du das nicht lernen, nimm eine App, die die Zeichen beim Arbeiten ausblendet. In Hem klickst du in die formatierte Seite und tippst, ganz ähnlich wie in Pages oder Word. Beim Markieren von Text erscheint eine kleine Leiste mit Fett, Kursiv, Überschriften, Listen, Checklisten, Links und Zitaten; ⌘B und ⌘I funktionieren wie gewohnt; „Format“ › „Tabelle einfügen“ fügt eine Tabelle ein; Checklisten hakst du per Klick ab. Hem sichert laufend in dieselbe .md-Datei und schreibt nur die Teile neu, die du geändert hast. Die Datei bleibt gewöhnliches Markdown, das ein KI-Tool und jede andere App weiterhin lesen kann.

Wie du sie umwandelst

In Word: In Hem sichert „Ablage“ › „Als Word-Dokument exportieren …“ eine .docx. Die anderen Wege, einschließlich Google Docs, beschreibt .md-Datei in ein Word-Dokument umwandeln.
In ein PDF: „Ablage“ › „Als PDF exportieren …“ in Hem.
In eine E-Mail oder ein anderes Dokument: In Hem mit ⌘C kopieren und in Mail, Word, Pages oder Google Docs einsetzen. Überschriften, Fettdruck, Listen und Tabellen kommen als Formatierung an, nicht als Zeichen.
Zurück an eine KI: Umwandeln ist nicht nötig. KI-Chats lesen Markdown problemlos, also setze den Text ein oder hänge die .md-Datei an, wie sie ist.

Kurz gesagt

Eine .md-Datei ist ein Textdokument, dessen Formatierung als Zeichen hineingeschrieben ist. Sie ist nicht kaputt, nicht gefährlich und nicht nur etwas für Programmierer. Sie braucht bloß eine App, die die Zeichen liest, und auf dem Mac musst du eine hinzufügen, weil keine mitgeliefert wird.