# MD file

An .md file is a plain text file written in Markdown. What it holds, how to open one on a Mac, and how to edit it without seeing every symbol.

**Definition:** 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](/glossary/markdown) marks for formatting. A line that starts with `#` is a heading, `*` or `-` starts a list item, and `**bold**` makes text bold ([every mark](/glossary/markdown-syntax)):

```markdown
# 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](/glossary/claude-md) and [AGENTS.md](/glossary/agents-md) are often .md files. Many .md files also hold [tables](/glossary/markdown-table), or start with a block of details about the file, such as its title and date, called [YAML front matter](/glossary/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](/for/markdown-editing).

## 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.

---

This is the Markdown copy of https://flywrite.app/glossary/md-file.
