Markdown is an easy-to-learn markup language that’s used to format plain text documents. Even if you have no previous experience with it, Markdown is so simple that it can be learned in under 10 minutes.
For example, if you want to make a word appear italicized, just surround it with asterisks (e.g. *test* becomes test). This also works for entire sentences or even paragraphs. If you want to make a bulleted list, just start each line with a hyphen character. Simple, right?
There are all kinds of Markdown editor apps out there, and you can even use Markdown in Microsoft Word. If you’re still a bit confused, check out our beginner’s introduction to Markdown. Otherwise, refer to the Markdown cheat sheet below for a quick overview of what you can do with it.
The Markdown Cheat Sheet
Format Type | Markdown Syntax |
---|---|
Basic Elements | |
H1 to H6 Headings |
# Heading Text |
Italics | *This text is italicized* |
Bold | **This text is bold** |
Blockquote | > Blockquote paragraphs must have |
Unordered List | - Bullet list item |
Ordered List | 1. Bullet list item |
Mixed List | 1. Can you mix list types? |
Horizontal Line | ---
Note: Either three hyphens, asterisks, or underscores. |
Hyperlink | This is an [example link](//www.makeuseof.com) |
Image | ![Alt Text](http://example.com/image/path.png) |
Ignore Markdown | Prefix Markdown characters with *backslashes* to ignore formatting. |
Extended Elements | |
Code (Inline) | `This is inline code` |
Code (Block) | ``` |
Strikethrough | ~~This text is crossed out~~ |
Hard Line Break | This is some text |
Table |
Note: Preceding blank line is necessary. |
Task Lists | - [x] Completed task item |
Mention | You can mention @users and @teams on GitHub. Mainly useful when submitting or commenting on bugs and issues. |
Emoji | :emojicode:
Note: Emoji codes can be found in the emoji cheat sheet. |
Note: Nearly all flavors of Markdown support the basic elements, but the extended elements are only supported by more advanced forms of Markdown, including CommonMark and GitHub Flavored Markdown.
What Are Markdown Flavors?
The original Markdown specification came about in 2004. However, as innovative as it was, many users felt that the original Markdown’s feature set was too limited for anything more than simple document formatting.
As various sites adopted Markdown as their preferred method for inputting text (e.g. blog posts, comments, forum posts, etc.), they began adding and supporting their own elements of Markdown markup. Notable sites include Reddit, GitHub, Stack Exchange, and more.
Eventually, users began pushing for a standardized set of formatting elements, leading to the creation of even more Markdown flavors like CommonMark, MultiMarkdown, Markdown Extra, GitHub Flavored Markdown, and more.
Long story short: Once you learn the basic elements set forth by the original Markdown specification, you’ll be able to pick up any other flavor of Markdown with ease. The variations are subtle and often only useful in very specific use-cases.
Read the full article: The Printable Markdown Cheat Sheet for Beginners and Experts