Markdown (MD)

basicwidespread

A simple markup system that lets you write headings, emphasis, lists and links in plain text using a few punctuation marks, which programs then display formatted.

In plain terms

Markdown is like underlining a title in a handwritten note, placing an asterisk next to an important word, and starting list items with a dash. You do not need to click formatting buttons in a text editor: you write the formatting into the text itself using a few familiar punctuation marks.

It lets a text be read in two ways. Raw, with the markup included, it stays understandable, and a rendering program turns it into neat headings, bold words, lists and tables.

It differs from a Word document in that a Markdown file is plain text: it can be opened on any machine with any program, is small, and will remain readable in ten years. In return, it has fewer features: it contains no formatting, font selection, or page numbering.

In the AI world, it became a basic term because language models typically respond in Markdown, and agents' instructions, notes, and documentation are also mostly stored in such files.

How it works

You write the text into a simple text file, which usually has the .md extension.
Formatting is indicated with punctuation: a hash (#) at the start of a line denotes a heading, two asterisks around a word (**like this**) indicate bold emphasis, and a hyphen at the start of a line signifies a list item.
A display program (chat interface, note application, website) reads the text and recognizes these symbols.
The program converts the markup, most often into the language of websites, HTML, so you see formatted text.
If the program does not recognize Markdown, there is no problem: you see the raw text with asterisks and hash signs, which is still readable.

An everyday example

You ask an AI chatbot to summarize a long article, and the response contains headings, bold keywords, and a bulleted list. The model wrote this in Markdown, and the chat interface displays it formatted. If you copy the answer into an email using the copy button and asterisks and hash signs appear in it, you are seeing the raw Markdown.

Who is affected

everyoneIf you use an AI chatbot, Markdown is almost always behind the formatting of responses, and its symbols may appear when copying.

developerProject descriptions, documentation, and instruction files for coding agents are typically created in Markdown. → Code

employeeMany note-taking, team-collaboration, and messaging applications understand Markdown syntax, allowing faster formatting without a mouse. → Work & HR

parent, student, teacherSuited to writing notes, outlines and assignments quickly, durably and independently of any particular software; it can be learned in a few minutes. → Education & Family

A common misconception

MythMarkdown is a programming language, so it is only for IT professionals.

In realityIt is not a programming language but a formatting markup: it calculates nothing and executes nothing, only indicating what should be a heading, emphasis, or list. You can learn its basics in a few minutes.

Limits and risks

There is no single, universal Markdown: several variants exist, so the same text (especially tables or footnotes) may render differently depending on the program.
It is not suitable for complex layouts, print typesetting or precise page design; a word processor or desktop publishing software is the right tool for that.
If you paste it into a place that does not recognize it (for example, many email clients), the formatting marks remain as raw punctuation in the text and must be cleaned up manually.
HTML code can be embedded in Markdown files, so the display program must filter content from unknown sources to avoid security risks.

Similar, but not the same

HTML – HTML is a detailed, tag-rich description language for web pages, while Markdown is a simplified, human-readable subset that can be converted into HTML.
Word-dokumentum – A Word file is a complex format where formatting is stored hidden and requires a suitable program to open, while a Markdown file is plain text where formatting marks are visible.
JSON – JSON is a strict, machine-oriented data format, while Markdown is used for formatting human-readable text.

Related concepts

Broader

Markup Language, File Format, Plain text

Narrower

GitHub Flavored Markdown, CommonMark

On the edge

HTML, JSON, YAML, Prompt, Documentation, README file

A brief history

John Gruber, an American blogger, published Markdown in 2004 with Aaron Swartz. The goal was to allow comfortable writing and reading of web text in raw form. The original specification was ambiguous in several areas, leading to inconsistent interpretations by software. The CommonMark initiative launched in 2014 to unify the standard, providing a detailed, shared specification since then.

Where things stand

At the end of 2026, Markdown is the usual format for developer documentation, note-taking apps and AI chatbots. Most language-model responses and most instruction files written for agents are also produced in it.

Status: 2026 November

In the news

Appears in 5 Agent Age stories; the curve shows weekly occurrence in the news magazine.

Perplexity blocks Time's ads aimed at AI agents, calling them deceptiveNov 2, 2026 · Marketing
Planted AGENTS.md file in Downloads folder hijacks AI coding agentsOct 25, 2026 · Code
Google's Mueller shares experience with Markdown for AI SEOAug 31, 2026 · Marketing
Perplexity blocks Time's ads served to AI agents, calling them deceptiveAug 10, 2026 · Marketing
Ads only AI can see: Time builds a separate site version, while buyers remain scepticalAug 5, 2026 · Marketing

Also known as

Markdown · markdown · MD · .md file · MD file · Markdown format · Markdown markup · Markdown nyelv

Sources

This entry was machine-edited and has undergone machine expert review; the “In the news” section updates automatically from Agent Age stories.