Introduction to Markdown

Markdown is a lightweight markup language that allows you to write using an easy-to-read, easy-to-write plain text format, which then converts to valid XHTML (or HTML). Created by John Gruber in 2004, it has become the de facto standard for developers, technical writers, and content creators.

It's used everywhere: GitHub READMEs, technical documentation, Slack messages, Notion pages, and static site generators like Jekyll and Hugo.

Basic Formatting

Headings

Headings are created by adding one or more \