How to open .MD files on Mac
To open .MD files on Mac, control-click the .md file → Open With → select a text editor or Markdown editor.
Step-by-step instructions
- Control-click the .md file → Open With → select a text editor or Markdown editor.
- If you need formatted viewing, open it in an editor that supports Markdown preview (for example, Visual Studio Code).
- To change the default, use Get Info → Open with → Change All.
Common issues
The file opens as plain text (no formatting)
Markdown is plain text; many apps only show the raw text and do not render headings, lists, and links as formatted content.
- Open the file in a Markdown-capable editor/viewer and enable its preview/rendered view (for example, VS Code Markdown preview).
- If sharing for viewing, consider converting/exporting to HTML or PDF using your Markdown tool (feature availability varies by app).
Rendering looks different in different apps
Markdown has variants/dialects, and different renderers support different features. A file written for one variant may render differently elsewhere.
- Check whether the file targets a specific variant; CommonMark is a widely used baseline specification.
- Avoid non-standard extensions where possible, or test the file in the renderer your audience will use.
Wrong app is associated with .md
The operating system may associate .md with an unexpected program, causing confusing open behavior.
- Change the default app for .md files using your OS “Open with” / “Get Info” default app settings.
- On Linux desktops, verify MIME associations (freedesktop.org shared MIME info commonly maps *.md).
Text looks garbled or special characters are wrong
Markdown files are text, and problems can occur if an app assumes the wrong character encoding. RFC 7763 also defines charset handling for text/markdown in MIME contexts.
- Open the file in an editor that lets you choose the text encoding and try UTF-8.
- If the file was delivered via email/web, ensure the correct charset is used for text/markdown in that system.
Security note
Markdown is plain text, but some viewers/renderers support embedded HTML; if a renderer allows HTML, opening untrusted .md in a web context can raise risks like unwanted links or HTML-based injection depending on the viewer’s sanitization.