Install the app and run it. This will register the availability of the app’s QuickLook extensions, Markdown Previewer and Markdown Thumbnailer. You can now quit the app.
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:
PreviewMarkdown will optionally preview YAML front matter at the start of your Markdown files. YAML is often used this way to hold metadata that will be read by static website generators when they read the Markdown content for page rendering.
You can disable or re-enable Markdown Previewer and Markdown Thumbnailer in System Preferences > Extensions:
Click on the settings button , or select Settings… from the PreviewMarkdown menu, to switch to the settings tab to adjust some of the key elements of the preview:
Choose your preferred text size — headings are scaled up from this value in even steps — using the slider, then pick the fonts in which you want text and code to be presented. You can also choose each font’s style:
Choose your preferred heading, code, blockquote and link colours by selecting the appropriate formatting element from the pop-up and then clicking on the colour well to bring up macOS’ standard colour picker. As you make your colour selection, the colour well will be updated. Switch to other formatting elements as you need, changing their colours as you go:
Click Apply to record your choices.
Changing these settings will affect all new previews immediately, though not any that are already open. Changes may not be seen in thumbnails until you open a folder that has not been previously opened during the current login session. Thumbnails are always presented dark-on-light, even under macOS’ Dark Mode. This is a Finder convention.
If you’ve made a bunch of changes and you don’t like the look of them, you may click the Defaults button to restore PreviewMarkdown’s standard settings. Don’t forget top click Apply to enforce the change — or just quit the app to keep the settings you applied before.
You can use the in-app UI to submit feedback or contact me. Just click the feedback button , or select Report a Bug… from the Help menu, to switch to the feedback tab. Enter your message of up to 512 characters and click Send:
Please include your email address if you would like a response — I can’t respond without one. Please see the privacy policy for details of email address usage.
PreviewMarkdown 2 will include image placeholders when it encounters image links in Markdown files, along with the image file’s path. Unfortunately, macOS’ sandbox permissions system does not appear to allow the previewer access to arbitrary files, only to the previewed file itself. We are actively exploring solutions to this problem and hope to provide full image previews shortly.
If it appears that either Markdown Previewer or Markdown Thumbnailer are not working after you have run the host app, please log out of your Mac and then log back in. You may also need to re-run the app after updating it.
Go to System Settings > General > Login Items & Extensions and click on the ⓘ symbol alongside the Quick Look entry under Extensions. Make sure Markdown Previewer and Markdown Thumbnailer are both switched on (see screenshot above)).
Some applications which can edit Markdown files may register a non-standard, proprietary Uniform Type Identifier (UTI) for Markdown files. PreviewMarkdown may not be aware of these UTIs and therefore may not be able to preview and thumbnail these files on your system. Finder will request previews and thumbnails not from PreviewMarkdown but from the app that ‘owns’ the Markdown UTI on your system.
PreviewMarkdown cannot display Markdown files if a pre-existing application has already taken ownership of the format. This is a limitation of macOS.
If you encounter this issue — typically, previews of markdown files will show the raw formatting text — please run utitool to see your system’s registered Markdown file UTI. This UTI will automatically be included in any message you send using PreviewMarkdown’s feedback facility.
Please include an email address in any feedback you provide or support request you make. I cannot respond to you without one.
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!
PreviewMarkdown makes use of code from the following sources:
You can view PreviewMarkdown’s source code at GitHub.
Convert Markdown Text to HTML
system-wide text service.public.markdown
UTI....
end marker (Thanks, anonymous).com.nutstore.down
.[ ]
[x]
.UTType
API.net.ia.markdown
.writer.pro.markdown
.string index out of range
in SwiftyMarkdown).