editmd / schoolSmall lessons. Useful documents.

MARKDOWN SCHOOL

Twelve lessons.
Useful documents.

Learn Markdown, work with YAML and write clear instructions for AI agents. Each lesson has a narrated video, an editable example and an exercise you can copy into your own editor.

Start with the first lesson

No account · progress stays in your browser

A GOOD FOUNDATION

Small steps. Real understanding.

Watch a short demonstration, explore the example, then try it yourself. Start at the beginning or choose the skill you need.

01
WATCH · READ · PRACTISE

A small format. A lasting idea.

Meet Markdown: readable text that can become a structured document.

02
WATCH · READ · PRACTISE

Choose the format for the work.

Use Markdown where readable, portable writing helps—and recognize when another format fits better.

03
WATCH · READ · PRACTISE

Make a note easier to scan.

Give every idea a place with a title and section headings.

04
WATCH · READ · PRACTISE

Turn a list into next steps.

Write ordinary lists, ordered steps and checkable tasks.

05
WATCH · READ · PRACTISE

Make your references useful.

Connect an idea to its source with a link that tells the reader what to expect.

06
WATCH · READ · PRACTISE

Ask for a review. Keep your judgment.

Give AI a bounded task, then verify the suggestions before changing your document.

07
WATCH · READ · PRACTISE

Read YAML as structured data.

Build named values, lists and nested settings, then separate syntax from meaning.

08
WATCH · READ · PRACTISE

Give a document useful metadata.

Combine YAML and Markdown, compare literal and folded text, and check a small schema.

09
WATCH · READ · PRACTISE

Write scoped instructions for Codex.

Create a concise AGENTS.md and reason about directory scope with a fictional project.

10
WATCH · READ · PRACTISE

Make Claude project guidance checkable.

Replace vague instructions with concrete project facts and verify what Claude Code loads.

11
WATCH · READ · PRACTISE

Inspect Gemini CLI context.

Write GEMINI.md guidance, inspect loaded context and distinguish editing from reloading.

12
WATCH · READ · PRACTISE

Build and test a focused skill.

Combine discovery metadata, a bounded procedure and positive and negative test cases.

TAKE A PROJECT WITH YOU

Start with a useful file.

Complete, editable examples. Download the Markdown, replace the fictional details and make the document yours.

KEEP THIS CLOSE

A small syntax reference.

# A title

## A section

A paragraph with **strong emphasis** and *emphasis*.

- An ordinary list item
- Another item

1. An ordered step
2. The next step

[CommonMark reference](https://commonmark.org/help/)

> A quotation

`inline code`

![What the image shows](images/sketch.png)

```
A code block
```

These are core Markdown forms. Task lists (- [ ]) and tables are extensions. See the CommonMark reference and GFM specification for their boundaries.

Agent-readable/learn.md
Save .md