---
title: "Markdown School"
description: "Twelve practical lessons with narrated videos, editable examples and exercises. Markdown foundations, YAML metadata and AI instruction files."
canonical: https://editmd.app/learn/
markdown: https://editmd.app/learn.md
status: pre-release, waiting list open
generated: editmd-website
---

# Markdown School

Twelve lessons. Each has a narrated video, an editable example and an exercise. No account; progress stays in the browser.

## Lessons

01. [A small format. A lasting idea.](https://editmd.app/learn/lessons/origins.md): Meet Markdown: readable text that can become a structured document.
02. [Choose the format for the work.](https://editmd.app/learn/lessons/formats.md): Use Markdown where readable, portable writing helps—and recognize when another format fits better.
03. [Make a note easier to scan.](https://editmd.app/learn/lessons/headings.md): Give every idea a place with a title and section headings.
04. [Turn a list into next steps.](https://editmd.app/learn/lessons/tasks.md): Write ordinary lists, ordered steps and checkable tasks.
05. [Make your references useful.](https://editmd.app/learn/lessons/links.md): Connect an idea to its source with a link that tells the reader what to expect.
06. [Ask for a review. Keep your judgment.](https://editmd.app/learn/lessons/review.md): Give AI a bounded task, then verify the suggestions before changing your document.
07. [Read YAML as structured data.](https://editmd.app/learn/lessons/yaml-basics.md): Build named values, lists and nested settings, then separate syntax from meaning.
08. [Give a document useful metadata.](https://editmd.app/learn/lessons/yaml-front-matter.md): Combine YAML and Markdown, compare literal and folded text, and check a small schema.
09. [Write scoped instructions for Codex.](https://editmd.app/learn/lessons/agents-md.md): Create a concise AGENTS.md and reason about directory scope with a fictional project.
10. [Make Claude project guidance checkable.](https://editmd.app/learn/lessons/claude-md.md): Replace vague instructions with concrete project facts and verify what Claude Code loads.
11. [Inspect Gemini CLI context.](https://editmd.app/learn/lessons/gemini-md.md): Write GEMINI.md guidance, inspect loaded context and distinguish editing from reloading.
12. [Build and test a focused skill.](https://editmd.app/learn/lessons/skill-md.md): Combine discovery metadata, a bounded procedure and positive and negative test cases.

## Example projects

- Meeting notes that lead somewhere: https://editmd.app/learn/examples/meeting-notes.md
- A welcoming project README: https://editmd.app/learn/examples/project-readme.md