What a markdown file actually is

You are about to hear the term. It sounds technical and it is not.

A markdown file is a plain text file with a .md on the end. That is genuinely all it is. You can open one in any text editor. There is no software to buy, no format to learn, and nothing that stops working when a company changes its pricing.

The reason everything here uses them is that both you and the AI can read the same file. It is a document to you and an instruction to it.

And here is the part that matters: you are not going to write them.

You describe roughly what you want, and the AI writes the file. You read it, tell it what is wrong, and it fixes it. Then it is yours, and you can edit a line of it in six months when something changes.

That is worth sitting with, because most people assume a system like this means learning to write configuration. It means learning to ask.

Sixty seconds, and the format never intimidates you again.

1. Open Notepad on Windows, or TextEdit on a Mac. Any plain text editor.

2. On a Mac only: TextEdit starts new documents in rich text. Choose **Format, then Make Plain Text** first, or what you save will not be a plain file.

3. Type one line. My name is [you]. This file is mine.

4. Save it as hello.md. If the editor insists on .txt, save it with whatever it offers, then rename the file to .md. On Windows, choose All Files in "Save as type" first so it does not add .txt.

5. Open it again. Same text, no magic.

That file is the same kind of object as everything your AI is about to build for you. If you are on a phone or a locked-down laptop and cannot save files, skip the exercise and hold on to the fact instead: a markdown file is text, nothing more.

One convention you will see constantly: a name like ABOUT_ME.md or AGENTS.md in capitals is just a filename. The capitals are habit, from a world where important files shout their names. Nothing breaks if yours are lowercase.

Now you know what the building material is. Next lesson, you build.

Stuck anywhere in this lesson? Reply to any Build Notes email and tell me where. I would rather fix the lesson than have you quietly give up.