How to open a .md file on a Mac (and actually read it)

Why does my .md file look like code?

A .md file looks like code on a Mac because it is written in symbols, and your Mac shows you the symbols.

A .md file is plain text written in Markdown. A line that starts with # is a heading. Words wrapped in ** are bold. Rows of | are a table. An app that understands Markdown turns those symbols into a page. An app that doesn't just shows you the raw text.

macOS has no built-in Markdown view: Apple's guides for Quick Look, Preview and TextEdit list no Markdown support (checked 28 September 2026). So whatever opens the file (TextEdit, Xcode, Quick Look or Safari), you get the symbols.

# Launch plan

**Owner:** Maya · **Status:** draft

| Step   | Due    |
|--------|--------|
| Beta   | Oct 1  |
| Launch | Oct 15 |

- [x] Write the plan
- [ ] Book the demo

Nothing is wrong with the file. It's a recipe, and TextEdit is showing you the recipe instead of the cake.

the file is fine. it just needs a reader.

If you want the full story of the symbols, read what a .md file is.

What happens when you double-click a .md file?

Double-clicking a .md file opens it in whichever app last claimed the .md file type on your Mac. This table shows the usual suspects. None of them format the file.

If your .md files suddenly started opening in Xcode, a code editor, or something odd like a mind-mapping app, that app claimed the file type when you installed it. You can change it back in ten seconds. Here's how to change the default app for .md files.

How do I open a .md file so it's readable?

To read a .md file on a Mac as a formatted page, open it in an app that understands Markdown. This table compares the real options, free ones first.

Prices checked 28 September 2026. For a longer side-by-side, see Markdown readers for Mac, compared.

How do I make every .md file open formatted?

Change the default app once, and every .md file opens formatted from then on.

1. Click once on any file ending in .md in Finder.
2. Press ⌘I, or choose File › Get Info.
3. Find Open with and pick your Markdown reader from the menu.
4. Click Change All, then Continue.

That's it. Double-click any .md file and it opens as a page.

In One Clear Reader you can skip those steps: on the welcome screen, click Make this my default .md reader. There's also an option to open .txt and .csv files in it (press ⌘K and search for it).

What if the AI gave me a path, not the .md file?

If an AI tool gives you a path instead of the .md file, paste that path into Finder or a Markdown reader. Don't go hunting through folders.

AI tools often tell you where they saved something instead of handing you the file. You get a line like Saved to ~/Documents/project/plan.md or /tmp/notes.md.

• In Finder: press ⇧⌘G, paste the path, press Return. Finder shows the file, and you can double-click it. If the path is wrapped in quotes or backticks, remove those first.
• In One Clear Reader: press ⌘L, paste, press Return. It cleans up the path for you, including quotes, backticks, a ~ at the start, or a line number like :142 on the end. The file opens formatted.

If the path starts with /mnt/ or /home/, stop looking. That path is on the AI's computer, not yours. Download the file from the chat instead. Where Claude saves files explains which paths are real on your Mac.

What if I can't find the .md file at all?

If you can't find a .md file an AI made, search for part of its name. You rarely remember the exact file name an AI chose.

• Spotlight: press ⌘Space and type part of the name, like launch plan. This finds most files, but not ones in hidden folders like /tmp or ~/.claude.
• One Clear Reader: type part of the name in the same box you'd paste a path into. It lists matching names first, then files that contain your words.
• Latest from your AI: One Clear Reader's welcome screen lists documents changed in the last 24 hours, newest first. It also checks the temp folder and Claude Code's plans folder, which normal search skips. That's usually where "I know Claude just made it" files are hiding.

For where each AI tool puts its files, see where AI tools save files on your Mac.

Can I edit a .md file after opening it?

Yes, you can edit a .md file in any app that edits text, because a .md file is plain text. The trick is changing it without breaking the formatting.

• TextEdit works, but you edit the raw symbols. One stray | can break a table.
• VS Code, Typora and Obsidian all edit Markdown well.
• One Clear Reader lets you edit the Markdown text for free. It shows you exactly what changed before it saves, and keeps earlier versions so you can undo. You can also edit the formatted page directly, like a Google Doc, and it saves back as clean Markdown (Pro).

The file stays a .md file either way, so your AI can keep reading and updating it. How to edit a .md file without breaking it covers the common traps.

Do I need to convert a .md file to Word or PDF to read it?

No, you don't need to convert a .md file to Word or PDF just to read it. Converting makes a second copy that your AI can't update, and the two drift apart.

Read the .md in a reader. Convert only when you need to send it to someone who doesn't use Markdown. When you do, see how to turn a .md file into a Word document or into a PDF.

Questions people ask