Markdown ist so gestaltet, dass es als reiner Text lesbar bleibt – trotzdem wollen Sie sehen, wie das fertige Dokument aussieht: ob die Tabelle stimmt, die Liste richtig verschachtelt ist und der Codeblock hervorgehoben wird. Eine Live-Vorschau zeigt das dargestellte Ergebnis neben dem Quelltext und aktualisiert es mit jedem Tastendruck.
Diese Anleitung vergleicht die gängigen Wege, Markdown in der Vorschau anzusehen, nennt die Funktionen, die im Alltag wirklich einen Unterschied machen, und zeigt einen schnellen Ablauf, mit dem Sie lokale Dateien im Browser öffnen – ohne etwas zu installieren und ohne sie an einen Server zu senden.
Drei Wege zur Markdown-Vorschau
1. Eine Vorschau im Code-Editor
VS Code, JetBrains-IDEs und viele andere Editoren haben eine eingebaute Markdown-Vorschau. Das ist eine gute Wahl, wenn Sie ohnehin in diesem Editor arbeiten. Die Nachteile: Der Editor muss installiert sein, für Formeln und Diagramme sind oft Erweiterungen nötig, und Sie können ihn nicht mal eben einer Kollegin geben, die nur eine README.md lesen möchte.
2. Eine Online-Markdown-Vorschau
Eine Website mit Editor links und Vorschau rechts ist die schnellste Option: Tab öffnen und lostippen. Der Haken: Online-Tools unterscheiden sich stark. Manche senden Ihren Text zum Darstellen an einen Server, manche speichern Dokumente ungefragt in Ihrem Browser, und viele unterstützen nur die Grundsyntax – keine Tabellen, keine Aufgabenlisten, keine Formeln.
3. Eine selbst gehostete Vorschau
Eine statische Web-App, die Sie selbst hosten, verbindet den Komfort einer Website mit voller Kontrolle: Sie läuft unter Ihrer eigenen Domain, sieht für Ihr ganzes Team gleich aus, und Sie bestimmen, was sie kann und was nicht. Diese Option beschreiben wir ausführlich in Markdown-Editor selbst hosten.
Worauf Sie bei einer Markdown-Vorschau achten sollten
Nicht jede Vorschau ist gleich angenehm. Diese Funktionen zählen, sobald Sie täglich damit arbeiten:
- Sofortige Darstellung. Die Vorschau sollte sich beim Tippen aktualisieren – ohne „Rendern“-Button und ohne spürbare Verzögerung.
- Synchrones Scrollen. In einem langen Dokument muss die Vorschau dem Editor folgen, damit der Absatz, den Sie gerade bearbeiten, rechts immer sichtbar ist.
- GitHub-Flavored Markdown. Tabellen, Aufgabenlisten, Durchstreichen, Fußnoten und Hinweisblöcke sollten genauso dargestellt werden wie auf GitHub. Wenn Sie nicht sicher sind, was das ist, werfen Sie einen Blick in den Markdown-Spickzettel.
- Codehervorhebung für die Sprachen, die Sie verwenden.
- Formeln und Diagramme, wenn Sie technische Dokumentation schreiben: LaTeX-Formeln und Mermaid-Diagramme.
- Lokale Dateien öffnen. Drag & Drop sollte für einzelne Dateien, mehrere Dateien und ganze Ordner funktionieren – samt der Bilder, auf die ein Dokument verweist.
- Export. Ist das Dokument fertig, brauchen Sie es meist als HTML, PDF oder saubere
.md-Datei. - Lokale Verarbeitung. Im Idealfall wird der Text in Ihrem Browser dargestellt und verlässt nie Ihren Computer. Das ist wichtig für interne Dokumentation, Verträge, Entwürfe und Notizen.
Ein schneller Ablauf mit dem Markdown Preview Editor
Der Markdown Preview Editor ist ein kostenloser Open-Source-Editor, der genau um diese Liste herum gebaut ist. So sieht eine typische Sitzung aus.
Schritt 1: Editor öffnen
Öffnen Sie die Online-Version oder Ihre eigene Kopie. Keine Anmeldung, keine Installation. Die Oberfläche gibt es in 15 Sprachen, und sie richtet sich automatisch nach der Sprache Ihres Browsers.
Schritt 2: Dateien öffnen
Ziehen Sie eine .md-Datei auf den Editor – oder mehrere Dateien auf einmal oder einen ganzen Ordner. Jedes Dokument öffnet sich in einem eigenen Tab mit eigenem Rückgängig-Verlauf. Bilder, Audio und Video, die Sie zusammen mit dem Dokument ablegen, erscheinen in der Vorschau, weil die relativen Pfade aus dem abgelegten Ordner aufgelöst werden.
Lieber mit der Tastatur? Drücken Sie Ctrl+O (⌘O auf dem Mac), um Dateien auszuwählen, oder nutzen Sie die Schaltfläche Ordner, um ein Verzeichnis zu öffnen.
Schritt 3: Mit der Vorschau daneben schreiben
Tippen Sie links im Editor; die Vorschau rechts aktualisiert sich sofort und scrollt mit. Die Formatierungsleiste fügt Überschriften, Listen, Links, Tabellen und Codeblöcke ein. Seltener genutzte Werkzeuge – Fußnoten, Hinweisblöcke, Formeln, Diagramme – finden Sie im ausklappbaren Erweiterten Editor, damit die Werkzeugleiste aufgeräumt bleibt.
Wechseln Sie mit einem Klick zwischen drei Ansichten: nur Editor, geteilte Ansicht und nur Vorschau. Auf dem Smartphone passt sich das Layout automatisch an, und die Werkzeugleiste klappt sich weg, bis Sie sie brauchen.
Schritt 4: Speichern oder exportieren
Wenn Sie fertig sind, speichern Sie das Dokument als .md, exportieren Sie es als eigenständige HTML-Datei oder drucken Sie es als PDF. Der Artikel Markdown in HTML und PDF umwandeln erklärt die Möglichkeiten im Detail.
Wohin gehen Ihre Dateien?
Bei vielen Web-Tools ist nicht leicht zu erkennen, ob Ihr Text hochgeladen wird. Ein nützlicher Test: Öffnen Sie die Entwicklertools des Browsers, wechseln Sie zum Tab Network (Netzwerk) und tippen Sie etwas. Tauchen beim Tippen neue Anfragen auf, verlässt Ihr Text möglicherweise die Seite.
Der Markdown Preview Editor stellt alles im Browser dar. Geöffnete Dateien werden lokal gelesen, und Dokumente werden nur im geöffneten Tab gehalten, es sei denn, Sie aktivieren in den Einstellungen Dokumente in diesem Browser merken. Externe Bilder und Links in einem Dokument werden erst geladen, wenn Sie es erlauben – das bloße Öffnen einer Datei kontaktiert also auch keine anderen Server.
Tipps für eine reibungslose Vorschau
- Legen Sie Bilder neben dem Dokument ab, in einem Ordner
images/oderassets/, und verlinken Sie sie mit relativen Pfaden. Ziehen Sie dann den ganzen Ordner hinein, und alles wird angezeigt. - Verwenden Sie eine
#-Überschrift pro Datei. Sie wird zum Titel des exportierten HTML und erleichtert die Navigation in langen Dokumenten. - Schalten Sie Zeilennummern ein, wenn Sie gemeinsam an Dokumenten arbeiten – dann lassen sich Review-Kommentare wie „Zeile 42“ leicht nachvollziehen.
- Nutzen Sie nachts das dunkle Design. Die Vorschau wechselt das Design zusammen mit dem Editor.
Häufig gestellte Fragen
Gibt es eine kostenlose Markdown-Vorschau, die offline funktioniert?
Der Markdown Preview Editor verarbeitet Dokumente vollständig im Browser, und Sie können eine eigene Kopie auf jedem Webserver hosten oder lokal mit Docker betreiben. Ist die Seite einmal geladen, hängt die Darstellung von keinem Server mehr ab.
Kann ich eine Markdown-Datei mit Bildern in der Vorschau ansehen?
Ja. Ziehen Sie die Markdown-Datei zusammen mit ihren Bildern – oder den ganzen Ordner – auf den Editor. Relative Bildpfade wie images/diagram.png werden aus den abgelegten Dateien aufgelöst.
Sieht die Vorschau genauso aus wie auf GitHub?
Die Vorschau verwendet eine Formatierung im GitHub-Stil und unterstützt GitHub-Flavored Markdown einschließlich Tabellen, Aufgabenlisten, Fußnoten und Hinweisblöcken. Dokumente sehen daher sehr ähnlich aus wie auf GitHub.
Kann ich mehrere Markdown-Dateien gleichzeitig öffnen?
Ja. Jede Datei öffnet sich in einem eigenen Tab, und ein Link von einer geöffneten .md-Datei auf eine andere wechselt zu deren Tab.