MarkdownPaper Open reader

Learn Markdown by seeing it

Markdown guides

Practical guides, from your first Markdown document to tables, diagrams and math. See the source beside the finished page, with examples you can open in the reader.

Guides
38
Topics
9
Hours of reading
2

packing.md

## Packing list

- [x] **Passport**
- [ ] Charger, *both* of them
- [ ] Gate `B14` at 9:40

The page

Packing list

  • Passport
  • Charger, both of them
  • Gate B14 at 9:40

Start here

The shortest path from "what is this?" to reading and writing useful Markdown.

5 steps
  1. Guide5 min readWhat Is Markdown? A Plain Guide With ExamplesMarkdown is a simple way to format plain text with symbols like # and *. What it is, what a .md file is, where it is used, and examples you can try.
  2. Guide5 min readMarkdown Tutorial for Beginners in 10 MinutesLearn Markdown in ten minutes by building one real document, step by step. Headings, bold, lists, links, a table and code, each shown as you type it.
  3. Guide6 min readMarkdown Cheat Sheet With Rendered ExamplesEvery common piece of Markdown syntax beside its rendered result. Headings, emphasis, lists, links, images, code, tables, task lists and footnotes.
  4. Guide3 min readMarkdown Example File, Explained Line by LineA free Markdown example file that explains itself. Every common feature, with a note on how it is written. Download the .md file or open it in a reader.
  5. Guide4 min readSample Markdown File to Download and TestA free sample Markdown file that uses every common feature, from tables and footnotes to math, diagrams and unsafe HTML. Download it or open it in a reader.

README files

Project front doors: what belongs in a README, and how to make one quickly.

2 guides

Syntax how tos

The everyday marks people look up while they are writing.

7 guides

Formatting and layout

What Markdown can style directly, and where a small amount of HTML helps.

7 guides

Structure and extras

The pieces that make longer files easier to scan, fold, and maintain.

6 guides

Diagrams and math

Text-based diagrams and equations that still render as finished page elements.

2 guides

Formats

The Markdown-adjacent conventions and flavors that explain why files render differently.

2 guides

Markdown and AI

The files coding agents read and write, and getting Markdown in and out of a chat.

5 guides

Converting

Turning a Markdown file into a web page or a Word document without losing its shape.

2 guides