What is markdown?
Markdown is a tiny set of typing habits that turn plain text into neatly formatted text. In this guide you will learn what it is, why it exists, and why it keeps showing up everywhere once you start working with AI.
In this guide, you will learn what markdown is, why it was invented, and why it turns up so often once you start working with AI.
The problem markdown solves
Imagine you are writing a note to a friend and you want one word to stand out. In a word processor you would reach for the mouse, highlight the word, and click the bold button. That works, but it means stopping to point and click every time you want to change how something looks.
Now imagine you could show that a word is bold using nothing but the keys in front of you, without ever leaving the flow of typing. That is the small, clever idea behind a plain-text formatting language called markdown.
You write ordinary text and sprinkle in a few simple symbols. A tool then reads those symbols and turns your text into headings, bold words, lists, and links. The symbols are chosen to look sensible even before they are turned into anything, which is the whole point.
What it looks like
Here is a short example. This is markdown as you would type it:
# My shopping list
I need to buy **milk** and *bread* today.
- Apples
- Coffee
- Cheese
Notice how readable that already is. The # marks a heading, the ** wraps a
word you want in bold, the single * marks something for italics, and the
dashes make a list. Even without anything converting it, you can tell what the
writer meant.
When a tool displays that markdown, the # line becomes a large heading, βmilkβ
appears in bold, βbreadβ in italics, and the dashes become a tidy bulleted list.
You wrote plain text, and you got formatted text out the other end.
Why it exists at all
Markdown was created back in 2004 by writers who wanted formatting that stayed readable in its raw form. Older ways of marking up text, like the code behind web pages, worked fine for computers but were cluttered and hard for a person to read.
The goal was a format you could write comfortably, read comfortably, and hand to a computer comfortably, all at once. That balance is why it spread. Today you will find markdown in note-taking apps, messaging tools, documentation sites, and, as you will soon see, in nearly every AI chat tool.
Try it yourself
You do not need any special software to try markdown, because it is only plain text. Open any AI chat tool and paste in this request:
Rewrite the following as a short note using markdown. Give it a heading,
put the most important word in bold, and turn the three tasks into a
bulleted list.
Tasks for today: email the landlord, book a dentist appointment, and
pay the electricity bill. The electricity bill is the urgent one.
Look closely at what comes back. You will see the same #, **, and - symbols
from earlier doing their jobs. You have now read markdown, asked for markdown, and
recognised it in the wild, all in a couple of minutes.
A common first impression
A common first impression is that markdown is a programming language or something only technical people use. It is neither. It is closer to a handful of typing habits, like using a dash to start a list, that happen to be understood by a lot of software.
You do not have to memorise every symbol to benefit from it. Learning even two or three will change how comfortably you work with text, and the rest come quickly once you need them.
Next steps
Now that you know what markdown is and why it exists, the natural next step is to learn the small set of symbols that do the heavy lifting. We will go through headings, bold, italics, lists, links, and code, one at a time, in the next guide.
Try it yourself
Put this into practice with a ready-made prompt.
Document Summariser
Turn a long document into a clear summary at the length, focus, and reading level you need, so you can grasp the key points fast.
Use this prompt β
See it in action
How to summarise a long document with AI
Turn a long report, contract, or article into a clear summary you can actually use, in a few minutes. You will learn how to get the length and focus you want, and how to check the summary is faithful to the original.
Works with Claude, ChatGPT, Gemini