Markdown, the small skill that makes AI easier

A ten-minute formatting skill that makes you better at reading, writing, and working with AI. No coding required.

If you have used an AI chat tool, you have already met markdown, even if nobody named it. Those tidy replies with headings, bold words, and neat bullet points are markdown doing its quiet work. It is a simple way to add formatting to ordinary text, it takes about ten minutes to learn, and it happens to be one of the most useful small skills for anyone working with AI. Here is why, and how to start.

What markdown is

Markdown is a way of writing formatted text using a few characters you already have on your keyboard. You put a couple of asterisks around a word to make it bold, a hash in front of a line to make it a heading, and that is the whole idea. There is no special software and there are no menus. You type the marks, and anything that understands markdown (an AI chat, a note app, this website) turns them into proper formatting.

Why it matters

It is just text. A markdown file is plain text, nothing more. It opens on any device, in any app, and it will still open in twenty years. Nothing is locked inside one company’s software, and there is nothing to go out of date. What you write stays yours, in the simplest possible form.

It stays readable either way. Even before it is turned into formatting, markdown reads cleanly. **important** still plainly means important. You are not staring at a wall of code, you are reading text with a light touch of structure. That plainness is the point.

AI models love it. This is the part that matters if you want to get more out of AI. Language models were trained on enormous amounts of markdown, so they read and write it fluently. When you give an AI a request with a clear heading and a few bold keywords, you are speaking its native grammar, and the answers come back sharper. Its replies arrive in markdown too. Learn the marks, and you are suddenly reading and writing in the same shorthand the model uses.

The four to learn first

Most of everyday markdown is these four. Here they are in raw form:

# A big heading
## A smaller heading

**bold text** and *italic text*

[a link people can click](https://example.com)

And what each one does:

  • Headings. A # at the start of a line makes a title. One # is the biggest; add more (##, ###) for smaller subheadings.
  • Bold. Wrap a word in two asterisks, **like this**, and it becomes like this.
  • Italic. One asterisk on each side, *like this*, gives you like this.
  • Links. Put the words in square brackets and the web address in round brackets right after: [text](https://example.com).

That is genuinely most of it. Lists, quotes, and the rest follow the same spirit, and you will pick them up as you go.

Going deeper

When you want the full picture, the clearest reference is the Markdown Guide. Start with its getting started page, then keep the cheat sheet to hand. If you would rather learn by doing, CommonMark has a good ten-minute interactive tutorial.

The best way in, though, is simply to use it. Next time you open an AI chat, give it a request with a heading and a couple of bold words, and watch how much better you both understand each other.


filed under
basics
More like this

Introduction

note