Markdown Cheat Sheet
Every Markdown syntax element on one page — core Markdown plus the GitHub Flavored Markdown extensions — with a dedicated deep-dive guide for each element.
Updated July 3, 2026
Quick Reference
| Element | Syntax | Guide |
|---|---|---|
| Heading | # H1 ## H2 ### H3 | Details → |
| Bold | **bold text** | Details → |
| Italic | *italic text* | Details → |
| Bold + italic | ***both*** | Details → |
| Strikethrough | ~~crossed out~~ | Details → |
| Link | [text](https://url.com) | Details → |
| Image |  | Details → |
| Unordered list | - item | Details → |
| Ordered list | 1. item | Details → |
| Checkbox (task) | - [ ] todo - [x] done | Details → |
| Blockquote | > quoted text | Details → |
| Inline code | `code` | Details → |
| Code block | ```js … ``` | Details → |
| Table | | A | B | |---|---| | Details → |
| Line break | two trailing spaces or \ | Details → |
| Horizontal rule | --- | — |
| Definition list | Term : definition | Details → |
| Footnote (GFM) | text[^1] [^1]: note | — |
| Escape character | \* literal asterisk | — |
Syntax Guides
Each guide covers the exact syntax, a rendered example, GitHub Flavored Markdown behavior, and the mistakes that most often break rendering.
Markdown Headings
Create a heading in Markdown by starting a line with 1–6 hash characters (#) followed by a space. One # is an H1, two ## an H2, down to ###### for H6.
Bold and Italic in Markdown
Make text bold in Markdown by wrapping it in two asterisks (**bold**) and italic by wrapping it in one (*italic*). Three asterisks give you both: ***bold italic***.
Markdown Links
Create a link in Markdown with square brackets around the link text followed immediately by the URL in parentheses: [link text](https://example.com).
Markdown Images
Embed an image in Markdown with an exclamation mark, alt text in square brackets, and the image URL in parentheses: .
Markdown Lists
Create an unordered list in Markdown by starting lines with a hyphen, asterisk, or plus sign (- item). Create an ordered list by starting lines with a number and period (1. item).
Markdown Checkboxes (Task Lists)
Create a checkbox in Markdown with a list item followed by square brackets: "- [ ]" for an unchecked box and "- [x]" for a checked one. This is GitHub Flavored Markdown task list syntax.
Markdown Tables
Create a table in Markdown with pipes (|) separating columns and a row of hyphens under the header. Colons in the separator row control column alignment.
Markdown Code Blocks
Write inline code in Markdown by wrapping it in single backticks (`code`), and multi-line code blocks by fencing them with triple backticks (```) on their own lines. Add a language name after the opening fence for syntax highlighting.
Markdown Blockquotes
Create a blockquote in Markdown by starting the line with a greater-than sign and a space: "> quoted text". Repeat the > on each line, or on blank lines between paragraphs, to continue the quote.
Markdown Strikethrough
Cross out text in Markdown by wrapping it in double tildes: ~~struck through~~. Strikethrough is a GitHub Flavored Markdown extension supported by most modern renderers.
Line Breaks in Markdown
Force a line break in Markdown by ending the line with two spaces, or with a backslash, or by inserting the HTML tag <br>. A single newline alone does not break the line — it joins into the same paragraph.
Markdown Definition Lists
Write a definition list in Markdown (where supported) by putting the term on one line and each definition on the next line prefixed with a colon and space. GitHub does not support this syntax — use bold terms with indented text as a portable fallback.
Frequently Asked Questions
What is Markdown?
Markdown is a plain-text formatting syntax created by John Gruber in 2004. Symbols like # and ** mark up structure (headings, bold, lists), and a renderer converts the text into HTML, PDF, or Word documents.
What is the difference between Markdown and GitHub Flavored Markdown (GFM)?
GFM is GitHub’s superset of CommonMark. It adds tables, task-list checkboxes, strikethrough, autolinks, and fenced code blocks with syntax highlighting — the elements most developers consider "normal Markdown" today.
What file extension do Markdown files use?
The standard extension is .md (also .markdown). A Markdown file is plain text, so any text editor can open it.
How do I convert a Markdown file to PDF or Word?
Paste the Markdown into a converter like MDTool’s Markdown to PDF or Markdown to Word tool — both run free in the browser with no signup, and preserve tables, checkboxes, and code blocks.