QuickLook generator for Markdown files.
C HTML Objective-C CSS Shell C++
Latest commit 6208c49 Oct 12, 2016 @tarwich tarwich committed on GitHub Merge pull request #70 from josiahwiebe/master
update styles for systems with San Francisco



by Phil Toland http://fiatdev.com

fixes and improvements by Michael Dominic K. http://www.mdk.org.pl


QLMarkdown is a simple QuickLook generator for Markdown files. It renders a preview of the selected Markdown file using Discount -- a C implementation of John Gruber's Markdown.pl script.

To update to the latest version of discount run ./discount-config/update-discount.sh

For more information on Markdown see http://daringfireball.net/projects/markdown/.


Simply copy QLMarkdown.qlgenerator to ~/Library/QuickLook or /Library/QuickLook.

If the newly installed plugin is not picked up instantly, you can run qlmanage -r in Terminal to refresh.

To uninstall, drag QLMarkdown into the trash.

Another method, provided you have Homebrew Cask installed, you can run the following commands to set things up:

$ brew update

$ brew cask install qlmarkdown

To uninstall:

$ brew cask uninstall qlmarkdown

Note: QuickLook doesn't allow selecting text by default. If you want to select the text in the markdown preview, you will need to enable text selection in QuickLook by running the following command in Terminal:

defaults write com.apple.finder QLEnableTextSelection -bool TRUE; killall Finder

This command is only valid on OS X 10.10 and below as Apple has since removed the ability to select text in QuickLook.


Source code is available at http://github.com/toland/qlmarkdown.

You can download the latest release from https://github.com/toland/qlmarkdown/releases


The QLMarkdown code is distributed under the same terms as Discount. See the file discount/COPYRIGHT for more information.

Version History

Version 1.3 - Jan 26, 2012

  • Major update of discount markdown engine

Version 1.2 - Oct 4, 2009

  • Work around a conflict with MacVim (thanks to godDLL)
  • Support for .mdml extension (alanhogan)
  • CSS that mimics Apple's ADC styling (jiho)

Version 1.1 - Feb 11, 2009

  • Adding a little bit of CSS styling. (mdk)
  • Replace the Perl markdown renderer with a native C one (discount). (mdk)
  • Conform to public plain-text. Will make spotlight index the file contents. (mdk)
  • Added support for .md file extension (sant0sk1)

Version 1.0 - July 15, 2008

  • Initial release.