An .md file is a plain text file written in Markdown, which marks headings, lists, links and bold text with ordinary characters, such as a hash sign before a heading.
What's inside
An .md file holds text with a few Markdown marks for formatting. A line that starts with # is a heading, * or - starts a list item, and **bold** makes text bold (every mark):
# Weekly notes
- Draft the **intro**
- Check every [link](https://flywrite.app)
Because it's plain text, any app that opens text files can open it, and agents such as Claude Code and Codex read and edit it directly. That's why README files, notes, newsletters and agent instruction files such as CLAUDE.md and AGENTS.md are often .md files. Many .md files also hold tables, or start with a block of details about the file, such as its title and date, called YAML front matter.
How to open an .md file on a Mac
- To read the text: Control-click the file in Finder, choose Open With, then TextEdit. You'll see the Markdown marks as characters.
- To read it formatted and edit it: open it in a Markdown editor, which shows headings, lists and links formatted instead of as symbols.
In Flywrite
Flywrite opens any folder of .md files as a project. Rendered view shows each file formatted, and ⌘E switches to Source view, where you see and edit every character. Your files stay plain .md files. More on Markdown editors for Mac.
Questions
Is an .md file safe to open?
An .md file is plain text, so opening it in a text editor shows its characters and runs nothing.
What's the difference between .md and .markdown?
None in the file itself. Both extensions mean a plain text file written in Markdown; .md is the more common one.