A tool to generate Markdown file QuickLook previews for macOS Catalina and up

Latest Release: 1.1.1

 New Version


How to Use PreviewMarkdown

Install the app and run it. This will register the availability of the app’s QuickLook extensions, Previewer and Thumbnailer. You can now quit the app: just click OK:

The PreviewMarkdown app UI

Using QuickLook in Finder — select a Markdown file (.md, .mdown or .markdown, for example) and press space — will pop up a rendered image of file:

The PreviewMarkdown app UI

You can disable or re-enable Previewer and Thumbnailer in System Preferences > Extensions:

Control PreviewMarkdown extensions in System Preferences, Extensions

For some background information on how Catalina delivers QuickLook previews, please see this blog post.

Feedback and Bug Reports

From version 1.1.1, you can use the in-app UI to submit feedback. Just click in the Send Feedback button in the main window, or select Report a Bug… from the Help menu:

The PreviewMarkdown app feedback mechanism


If it appears that either Previewer or Thumbnailer are not working after you have run the host app, please log out of your Mac and then log back in. A future release will offer to do this for you.

Enjoyed Using PreviewMarkdown?

If you have found PreviewMarkdown to be useful, please consider writing a positive review on the Mac App Store, or simply give it a rating.

Thank you!


In addition to its own code, PreviewMarkdown makes use of code from the following sources:

Release Notes

  • 1.1.1 1 October 2020
    • Add report bugs/send feedback mechanism.
    • Add further usage advice to the main window.
    • Handle markdown formatting not yet rendered by SwiftyMarkdown: three-tick code blocks; HTML symbols; space-inset lists.
  • 1.1.0 25 September 2020
    • Add macOS Big Sur support.
    • Better macOS dark/light mode support.
    • Migrate engine to SwiftyMarkdown 1.2.3.
  • 1.0.5 9 April 2020
    • Mac App Store version.
  • 1.0.4 Not Released
  • 1.0.3 10 December 2019
    • Add the version number to the app info dialog.
  • 1.0.2 4 December 2019
    • Fix random crash (string index out of range in SwiftyMarkdown).
  • 1.0.1 20 November 2019
    • Correct thumbnail styling.
  • 1.0.0 8 November 2019
    • Initial public release.

Source Code

You can view PreviewMarkdown’s source code at GitHub.

Related Software

The Seal of RassilonThe Seal of Rassilon
Site and software copyright © 2020, Tony Smith
Site Last Updated: 23 October 2020