.md

Preview Markdown files on your Mac

Press Space on a README or any .md file and see it rendered — tables, task lists, front matter and highlighted code blocks — with the source one click away.

Rendered Markdown with tables and code in FinderPeek Quick Look
Rendered Markdown with tables and code in FinderPeek Quick Look

What is a Markdown file?

Markdown is the plain-text format behind READMEs, docs sites, notes apps and static-site generators. In Finder it normally shows as raw text with all its # and * symbols.

What you see with FinderPeek

  • check_circleRendered headings, tables, task lists and quotes
  • check_circleFront matter and syntax-highlighted code blocks
  • check_circleMDX, Quarto and R Markdown
  • check_circleSource view one click away

How to open Markdown files on your Mac

  1. 1

    Install FinderPeek

    Get it from the Mac App Store and open it once.

  2. 2

    Turn on its viewers

    In System Settings › General › Login Items & Extensions › Quick Look, enable the FinderPeek viewers you want. Use “Check a File” in the app to see which viewer handles a file.

  3. 3

    Select a file and press Space

    In Finder, click your Markdown file and press the Space bar to read it right away.

lock Everything happens on your Mac. FinderPeek never connects to the internet and collects no data.

Questions

How do I preview a Markdown file on a Mac?

Install FinderPeek and enable its Doc Viewer. Select the .md file in Finder and press Space.

Does it load images or scripts from the web?

No. The preview makes no network requests and JavaScript is off.

Can I see the raw Markdown?

Yes. Switch to the Source view at any time.

More FinderPeek guides

See everything FinderPeek can do →