Wie man eine .md-Datei öffnet

Eine Markdown-Datei ist reiner Text. Alles, was Text öffnet, öffnet sie — die Frage ist, was sie wie ein Dokument aussehen lässt.

Was es ist

Eine `.md`-Datei ist eine Textdatei mit ein paar Konventionen darin: eine Raute für eine Überschrift, Sternchen für Betonung, Bindestriche für eine Liste. Nichts in der Datei ist binär und nichts ist komprimiert, ein Texteditor zeigt also sofort die ganze Wahrheit über sie.

Genau deshalb sieht sie unfertig aus. Die Konventionen sind Anweisungen für einen Renderer, und bis etwas sie rendert, liest man die Anweisungen statt des Dokuments.

Auf einem Computer

Unter Windows öffnet Notepad sie und zeigt den rohen Text. Auf einem Mac tut TextEdit dasselbe, fragt aber unter Umständen zuerst, ob es die Datei umwandeln soll — ablehnen, dann bleibt sie reiner Text. Auf beiden rendert VS Code eine Live-Vorschau neben der Quelle, und das kommt der fertigen Seite am nächsten, ohne den Editor zu verlassen.

Die Datei auf ein Browserfenster zu ziehen funktioniert nicht so, wie man es erwartet: der Browser zeigt den rohen Text oder bietet an, ihn herunterzuladen, denn kein Browser rendert Markdown von sich aus.

Auf einem Telefon

Auf den meisten Telefonen ist kein Markdown-Reader installiert, und sie bieten an, die Datei in einer Notizen- oder Dateien-App zu öffnen, die den Text so zeigt, wie er geschrieben ist. Unter iOS zeigt Dateien eine Vorschau als reinen Text; unter Android hängt das Verhalten davon ab, welcher Texteditor installiert ist.

Sie vorher in HTML umzuwandeln geht meist schneller, als einen Reader zu suchen, denn jedes Telefon hat schon einen Browser, und jeder Browser öffnet HTML.

Was üblicherweise schiefgeht

Eine Datei, die ein Texteditor mit seiner eigenen Endung als `notes.md.txt` gespeichert hat, wird von nichts erkannt, das nach Markdown sucht. Umbenennen, und das Problem ist weg.

Tabellen, Fußnoten und Aufgabenlisten stehen nicht in der ursprünglichen Markdown-Spezifikation, ein Reader, der die Pipe-Zeichen und Klammern wörtlich anzeigt, ist also nicht kaputt — er setzt den Kern um und nicht die Erweiterungen.