How do I take a quick look at a .md file in Finder?
Select the file in Finder and press Space. PilcrowMD for Mac (beta) adds a Quick Look preview that shows the file in its reading look, not as raw text. It follows light or dark from your Mac, it is read only, and it uses no network. For a file over 512 KB it shows the first 512 KB.
One thing to know: Quick Look starts working after you have approved the app and opened it once. After that, Space works on any .md file in Finder.
How do I open a .md file in PilcrowMD?
Use File › Open and pick the file. PilcrowMD opens .md, .markdown and plain .txt files. A file that is not UTF-8 text is refused with a message and never overwritten.
The first time you open the app, macOS shows its "Apple checked it" dialog, because PilcrowMD is signed and notarized by Apple. Click Open. There is no extra step in Privacy & Security.
Each file opens in a tab, and you can have several windows. To start a new document, use File › New Window (⌘N) or New Tab (⌘T).
How do I open a whole folder of notes?
Add the folder in My folders in the sidebar. You can browse its subfolders, follow links between the notes, and see new and updated notes marked. Recent lists the files you opened lately.
If you work with AI coding agents, the folder is also where their plans and reports show up. That is covered in reading the Markdown files your AI agents write.
How do I make it comfortable to read?
PilcrowMD has three modes: Read, Split and Edit. Switch with ⌥⌘1, ⌥⌘2 and ⌥⌘3. Reading is the default way to look at a file you did not write.
Three reading looks are built in: Calm (the default), Document and Open. Two settings change how a page sits: line width (Wide is the default) and line spacing. You can also choose Light or Dark, one of three font sets, and the text size.
Tables, task lists, callouts, collapsible sections, code in colour for 28 languages, pictures stored beside the note, and maths with $ and $$ all draw as a page. Mermaid diagrams are drawn on your Mac, offline. A Markdown file with YAML at the top shows that block as a code block in the reader.
How do I find my way around a long file?
The Contents panel lists the headings of the open file. Click a heading to jump to it, and use Collapse All or Expand All to fold the list. Links inside a document also jump to their heading, including headings in other alphabets.
To search, use Find. Find & Replace (⌥⌘F) adds Match case, Whole word and Regular expression, and is hidden in Read mode.
What happens if the file changes while it is open?
If another app changes the file you are reading, PilcrowMD reloads it and keeps your place. If you have unsaved edits, it shows a banner instead of overwriting them.
PilcrowMD writes to a file only when you edit and save. Saving is all-or-nothing, and it keeps your line endings, so your Markdown comes back exactly as you wrote it.
Does it send my files anywhere?
No. The Mac app makes no internet connection. It runs in Apple's App Sandbox, and links to notes outside your added folders say "Outside My folders" instead of opening.
Ready to try it? Get PilcrowMD for Mac (beta). For more, see Markdown syntax in one page and tables in Markdown.
Also on Mac: PilcrowMD for Mac (beta)