Support

Questions, bug reports, and feature requests are all welcome at [email protected].

Frequently Asked Questions

Pressing space still shows plain text

Quick Look extensions have to be switched on before macOS will use them:

  1. Move qlmd to your Applications folder and open it once
  2. Open System Settings → General → Login Items & Extensions
  3. Find Quick Look in the Extensions list and make sure qlmd is turned on
  4. Close the preview and press the space bar again

If it still shows plain text, run qlmanage -r in Terminal to reload the Quick Look generators, or log out and back in.

Which files does qlmd preview?

Files with the extensions .md, .markdown, .mdown, and .mkd.

I changed a setting, but the preview looks the same

Settings apply to the next preview. Close the Quick Look window and press the space bar again. macOS also caches previews per file — if a document you already looked at still shows the old style, run qlmanage -r cache in Terminal.

My code block isn't highlighted

qlmd bundles a focused set of languages (Swift, JavaScript, TypeScript, Python, Bash, JSON, YAML, XML/HTML, CSS, Go, Rust, C, Java, Ruby, SQL, diff, and Markdown, plus the usual aliases). A language outside that set is shown as plain text rather than highlighted. Tell us which language you need and we will consider adding it.

A Mermaid diagram is shown as code

Check that Mermaid is turned on in the qlmd app's Extensions tab. If it is on, the diagram source may not be valid Mermaid — the same document rendered on GitHub will show the same problem.

An image in my document doesn't appear

Images referenced by a relative path are resolved against the folder the document is in. If the file has been moved or renamed, qlmd shows the alt text instead of the image. Remote images (http:// / https://) are not loaded: the preview is blocked from making network connections by design.

Which macOS versions are supported?

qlmd requires macOS 15 (Sequoia) or later. You can check your version from Apple menu → About This Mac.

Does qlmd send my documents anywhere?

No. Everything is rendered on your Mac, and the preview cannot open a network connection. See the privacy policy for details.

Still stuck?

Email [email protected] with your macOS version, the qlmd version (the app's About tab), and — if you can share it — the Markdown file that misbehaves.