Mac guide

How to change the default app for Markdown (.md) files on Mac

Works on macOS Sonoma, Sequoia and Tahoe.

Markdown is plain text with light formatting marks, used for READMEs, notes and documentation. A Mac opens .md files in TextEdit, or in Xcode once Xcode is installed. Neither shows the formatting. A Markdown editor or your code editor is a better default.

Change it in Finder

  1. In Finder, select any .md file.
  2. Choose File → Get Info, or press ⌘ I.
  3. Expand Open with and pick the app. If it isn't listed, choose Other….
  4. Click Change All… and confirm.

Without Change All…, only that one file changes. Since macOS 26.4, Finder also asks you to confirm before a file-type default changes.

Apps that open Markdown (.md) files on Mac

.markdown is the same type

Files ending in .markdown share a type with .md, so one change covers both.

Change it from Terminal

The free command-line tool duti sets defaults without Finder. Install it with Homebrew:

brew install duti

Then, to make Visual Studio Code open every .md file:

duti -s com.microsoft.VSCode .md all

The first argument is the app's bundle identifier. To find it for any app:

osascript -e 'id of app "Visual Studio Code"'

macOS may still ask you to confirm the change.

macOS identifies this file type as net.daringfireball.markdown.

Change it in Defaultify

  1. Open Defaultify and choose Code & Developer, or search for .md.
  2. On the Markdown Files (.md) row, open the app menu and choose the app you want.
  3. Confirm in the Finder dialog.

The free version shows which app opens this type. Changing code and developer types is part of Defaultify Pro ($6.99, once). You can also drag any file onto the Defaultify window to see what opens it.

Manage every default in one place

Defaultify for Mac shows all your file-type and link defaults in one window, flags missing ones, and with Pro warns you when an app takes one over.

Get Defaultify for Mac

If it changes back

Some apps claim file types again when they update. See how to stop apps from changing your defaults, and what to check when a change doesn't stick.

Related guides