# Markdown

Markdown is a way to format plain text with ordinary characters. What it looks like, where it came from and why writers and AI agents use it.

**Definition:** Markdown is a way to format plain text with ordinary characters, such as a hash sign before a heading or asterisks around a bold word, so the text reads cleanly as it is and converts to a formatted page.

## What it looks like

A Markdown file, usually an [.md file](/glossary/md-file), is plain text with a few marks. You can read it as it is, and a Markdown app shows it formatted:

```markdown
# Issue 42

This week: **three** notes and one [link](https://example.com).

- Draft the intro
- Cut the second section
```

The `#` line becomes a heading, `**three**` becomes bold, the brackets become a link and the dashes become a bulleted list. The full set of marks is on [Markdown syntax](/glossary/markdown-syntax).

## Where it came from

John Gruber created Markdown in 2004, with Aaron Swartz's feedback on the syntax, as a format that reads like plain text and converts to HTML for the web. His description left some cases open, so apps drifted apart. CommonMark is a stricter specification of the same syntax, and GitHub Flavored Markdown builds on CommonMark with extras such as [tables](/glossary/markdown-table), task lists and strikethrough.

## Why writers and agents use it

- **Any app opens it.** A Markdown draft is a plain text file, so it isn't locked to one app, and it works with version control such as Git.
- **Agents read and edit it directly.** Claude Code, Codex and other [CLI agents](/glossary/cli-agent) work on text files, so they edit a Markdown draft in place. Their instruction files, such as [CLAUDE.md](/glossary/claude-md) and [AGENTS.md](/glossary/agents-md), are Markdown too.
- **The marks are few.** Headings, emphasis, lists, links and quotes cover most drafts: newsletters, articles, scripts, lessons and specs.

## In Flywrite

Flywrite is a Markdown writing app for Mac. Rendered view shows each file formatted, and ⌘E switches to Source view, where you see and edit every mark. The editor follows CommonMark with GitHub's extensions, and your projects stay plain folders of .md files. More on [Markdown editors for Mac](/for/markdown-editing).

## Questions

### Is Markdown a programming language?

No. Markdown is a set of formatting marks for plain text. Nothing in a Markdown file runs; an app reads the marks and shows the text formatted.

### What's the difference between Markdown and an .md file?

Markdown is the format. An .md file is a plain text file written in it, the way a .txt file holds plain text with no marks at all.

## Sources

1. [Daring Fireball: Markdown](https://daringfireball.net/projects/markdown/), checked 2026-11-10
2. [CommonMark](https://commonmark.org/), checked 2026-11-10
3. [GitHub Flavored Markdown Spec](https://github.github.com/gfm/), checked 2026-11-10
4. [Flywrite docs: The editor](/docs/the-editor), checked 2026-11-17

---

This is the Markdown copy of https://flywrite.app/glossary/markdown.
