Back to Blog

How to Set the Default Markdown Editor on Mac

August 11, 2026Updated November 15, 2026by TypeFire
default markdown editor macset default app md file macchange default app macmd file opens in xcodeopen with markdown mac

You double-click a .md file and Xcode opens. Or TextEdit. Or whatever installed itself most recently and claimed the file type.

macOS decides this per file extension, and it can be changed permanently in about ten seconds.

How to Set the Default Markdown Editor on Mac

The one-click way

TypeFire does it in one click. Open Settings, then General, and next to Default Markdown editor click Set as Default. Every .md file now opens in TypeFire, formatted as you type, and pressing Space on one in Finder previews it without opening anything.

Once TypeFire is the default, Space previews a .md file and a double click opens it formatted.

Download TypeFire free for Mac

The manual way

Prefer to do it by hand, or want a different app? This works for any file type, not just Markdown.

  1. Right-click any .md file in Finder
  2. Choose Get Info, or press ⌘ I
  3. Find the Open with section and expand it
  4. Pick the app you want from the dropdown
  5. Press Change All, then confirm

That is it. Every .md file on your Mac now opens in that app.

The step people miss is Change All. Choosing an app in the dropdown without pressing it only changes that one file, which is why the problem seems to come back.

Why it keeps reverting

Three common causes.

You changed the file, not the type. Without pressing Change All, you set an override for that single file.

An app re-claimed it on update. Some apps, developer tools especially, re-register themselves as handlers when they update. Xcode is the usual culprit. Redo the Get Info steps.

Different extensions. Setting .md also sets .markdown, because macOS files both under one Markdown type. The rarer .mdown and .mkd are separate types as far as Launch Services is concerned, so repeat the process for those, or rename the files.

The nuclear option

If Launch Services has genuinely got confused and nothing sticks, rebuilding its database usually clears it:

/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user

Then restart Finder. This resets all file associations, so treat it as a last resort rather than a first move.

What to actually set it to

Depends on the job:

  • Reading and editing both? TypeFire is free, formats as you type, and previews every .md file when you press Space in Finder
  • Reading mostly? Set an app that renders on open, and separately install a Quick Look extension so you rarely need to open anything at all
  • Writing long form? Typora or iA Writer
  • Notes and linking? Obsidian
  • Files scattered across projects? Something that opens fast and renders immediately, since you are glancing rather than composing

Worth pairing with Quick Look

Setting a default editor solves double-clicking. It does not solve the more common case, which is wanting to read a file without opening anything.

Those two together, a default app for editing and Quick Look for reading, is the setup that actually removes the friction. TypeFire does both: one-click default registration, plus a Quick Look extension so space in Finder renders any .md file.

Download TypeFire free for Mac or read the Markdown tour.

Not on your Mac right now? Read any file in the browser with the free MD reader, or see what a .md file is.

In their words

Loved by people who type all day.

Unprompted reactions from users, in their own words.

Exactly what macOS has been needing: blazing fast, beautifully designed, and it respects your privacy without forcing a subscription.
Physician
I use TypeFire every single day, all day long. I love it.
Works at Apple
The way you've handled the AI integrations is very elegant. A great implementation.
Mac user
TypeFire is the absolute replacement for TextExpander.
Works at Apple
I love your app. Love it. The only one that does what I want it to do.
Mac user
I'm loving the date math. Amazing, love it.
ICU doctor
It instantly imported my 502 snippets. Flawless import.
Moved over from TextExpander
Incredibly lightweight. It has quickly become a go-to tool in my daily workflow.
Physician
Love the app, and your development pace rocks.
Longtime user
This app is AWESOME! And I definitely want to buy the Pro version.
Free user
Fantastic. Thank you for the very fast fix.
EU keyboard user
This app has so much potential. I'm really grateful that I found it.
Mac user

Used by people at

AppleRed HatPalo Alto NetworksHubSpotIndeedSentryFreshworksTrustpilotBumbleFarfetchSaint-GobainfoodpandaMcKinseyAccentureIntuitInstacartRakutenDow JonesHearstRokuxAINuroGitGuardianMeltwaterDevRevWoltAirwallex

Company names are places where our users work. They do not imply endorsement or affiliation.