Zum Inhalt

Markdown-Preview-Plugin

Eine Live-Vorschau des aktiven Markdown-Dokuments direkt daneben, dargestellt in einem andockbaren Panel, das sich beim Tippen aktualisiert. Der Renderer kommt ohne Abhängigkeiten aus (er verwendet Qts eingebaute Rich-Text-Ansicht, keine Web-Engine), daher ist dieses Plugin immer verfügbar und bringt keine schweren Abhängigkeiten mit.

Wo zu finden

Ansicht ▸ Markdown-Vorschau öffnet (oder schließt) das Vorschau-Dock für den aktuellen Tab. Das Dock bevorzugt die rechte Seite und kann wie jedes andere Panel gezogen, abgelöst oder als Tab angeordnet werden.

Verhalten

  • Live-Rendering. Die Vorschau wird beim Tippen neu gerendert, mit Verzögerung (Debounce), damit die Eingabe flüssig bleibt (bei sehr großen Dateien lockert sich die Verzögerung automatisch).
  • Dem Cursor folgen. Mit aktiviertem Cursor folgen (Werkzeugleiste) scrollt die Vorschau so, dass der gerade bearbeitete Block sichtbar bleibt. Deaktivieren Sie es, um die Vorschau unabhängig zu scrollen. Die Einstellung wird gemerkt.
  • Theme-bewusst. Die Vorschaufarben stammen aus dem aktiven Editor-Theme (Text, Codeblöcke, Blockzitate, Links), sodass die Vorschau zu einem hellen oder dunklen Theme passt und sich beim Theme-Wechsel live aktualisiert. Diese Farben können Sie im Theme Editor unter den Markdown-Kategorien feinjustieren.
  • Exportieren / im Browser öffnen. Die Werkzeugleiste kann das gerenderte HTML in eine Datei exportieren oder im Standardbrowser öffnen. Exportiertes HTML verwendet ein festes helles Stylesheet, damit die geteilte Datei unabhängig von Ihrem Editor-Theme normal lesbar ist.

Sichtbarkeit der Vorschau

Die Sichtbarkeit der Vorschau wird pro Datei gemerkt, sowohl innerhalb einer Sitzung als auch über Neustarts hinweg:

  • Markdown-Dateien (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) öffnen die Vorschau automatisch, wenn Sie sie zum ersten Mal ansehen. Dieser „Auto-Öffnen“-Standard ist ein dauerhafter Schalter unter Ansicht ▸ Markdown-Vorschau automatisch öffnen.
  • Andere Dateien nicht — aber Sie können die Vorschau für jede Datei mit Ansicht ▸ Markdown-Vorschau öffnen; die Datei wird dann als Markdown gerendert.
  • Innerhalb einer Sitzung wird Ihre Wahl für einen Tab wiederhergestellt, wenn Sie zu ihm zurückwechseln.
  • Über Neustarts hinweg wird Ihre ausdrückliche Wahl für eine Datei gemerkt: Schließen Sie die Vorschau für eine Datei, bleibt sie beim nächsten Öffnen dieser Datei geschlossen; öffnen Sie die Vorschau für eine Datei, die sich nicht automatisch öffnen würde, öffnet sie sich erneut. Dateien, deren Vorschau Sie nie ausdrücklich angefasst haben, folgen einfach jedes Mal dem Auto-Öffnen-Standard — ein später aktiviertes Auto-Öffnen öffnet also weiterhin Vorschauen, die Sie nie bewusst geschlossen haben.

Was gerendert wird

Überschriften, fett / kursiv, Inline-code und eingezäunte Codeblöcke, geordnete und ungeordnete Listen, Blockzitate, horizontale Linien, Links, Bilder (relativ zur Datei aufgelöst), Autolinks und harte Zeilenumbrüche. Text wird HTML-escaped und rohes eingebettetes HTML wird nicht ausgeführt — die Vorschau eines Dokuments führt also niemals beliebiges Markup aus.

Siehe auch

  • HTML-Vorschau — vollwertige Vorschau (CSS/JavaScript) für HTML und PHP, mit QtWebEngine.
  • Theme Editor — die Markdown-Farben der Vorschau anpassen.