Black Friday sale: 30% off Flywrite

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, is plain text with a few marks. You can read it as it is, and a Markdown app shows it formatted:

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

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, 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 work on text files, so they edit a Markdown draft in place. Their instruction files, such as CLAUDE.md and 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.

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. Checked .
  2. CommonMark. Checked .
  3. GitHub Flavored Markdown Spec. Checked .
  4. Flywrite docs: The editor. Checked .

Write with your agent in a writing app.

Buy now