macOS Finder Preview Pane not rendering Markdown

Finder Preview Pane (Sidebar) won't render Markdown—only shows "Information/Metadata" list.


Message:

I’m having a nightmare of a time with the macOS Finder Preview Pane (the right-side panel, NOT the Spacebar Quick Look).

The Problem: Even with QLMarkdown or Peek installed and enabled in System Settings > Extensions, the Finder Preview Pane refuses to render the Markdown content. Instead, it only shows the file icon and a list of metadata (Tags, Dates, Information).

When I go to View > Show Preview Options, the window is titled "Preview Options - Text" and it is missing the "Show Preview" checkbox entirely. It seems macOS is hard-locking .md files into a "Text" category that only allows for metadata display in the sidebar.

What I’ve already tried (none of this worked):

  • Installed and enabled QLMarkdown and Peek in Extensions.
  • Spacebar Quick Look works perfectly and renders the MD, but the sidebar panel does not.
  • Changed "Open With" to the preview apps and clicked "Change All."
  • Ran qlmanage -r, qlmanage -r cache, and killed quicklookd / Finder.
  • Resized the preview pane (made it very wide).
  • Deleted the Finder plist and restarted.

Goal: I want to keep Sublime Text as my default editor for .md files but actually see the rendered content in the Finder sidebar.

Has anyone found a way ?

MacBook Pro 14″, macOS 15.7

Posted on Feb 17, 2026 8:51 AM

Reply

There are no replies.

macOS Finder Preview Pane not rendering Markdown

Welcome to Apple Support Community
A forum where Apple customers help each other with their products. Get started with your Apple Account.