# Enable markdown rendering in macOS Finder

Published: 2026-01-21T00:00:00.000Z
Canonical: https://wow.pjh.is/journal/qlmarkdown-quick-look

In macOS, the Finder Quick Look feature shows markdown files as raw text:

![Screenshot of Finder preview without markdown rendering](https://wow.pjh.is/static/images/blog/ql-markdown-before.jpeg)

To fix this, install [QL markdown](https://github.com/sbarex/QLMarkdown):

```bash
brew install --cask qlmarkdown
```

Then you'll get:

![Screenshot of QL markdown](https://wow.pjh.is/static/images/blog/ql-markdown.jpeg)

Ugh, that typography is rough, huh. I'll make a custom theme soon, and share it here!