## Reference

Markdown Cheat Sheet

Everything you need to write Markdown, in one place. Raw syntax on top, what it does below. Bookmark this page.


## Headings

Headings

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Use # symbols followed by a space. More # symbols = smaller heading. H1 is the largest, H6 the smallest.


## Text Formatting

Text formatting

**bold text**

Wrapping text in double asterisks makes it bold.

*italic text*

Single asterisks make text italic.

***bold and italic***

Triple asterisks combine bold and italic.

~~strikethrough~~

Double tildes create strikethrough text.

`inline code`

Backticks render text in a monospace code font, inline with surrounding text.


## Links & Images

Links and images

[Link text](https://example.com)

Square brackets hold the visible text, parentheses hold the URL.

[Link with title](https://example.com "Title")

Add a title in quotes after the URL. It shows as a tooltip on hover.

![Alt text](image.png)

Same as a link but with ! prefix. The alt text describes the image for accessibility.

[reference link][1]

[1]: https://example.com

Reference-style links keep your Markdown clean. Define the URL elsewhere in the document.


## Lists

Lists

- Item one
- Item two
- Item three

Unordered lists use -, *, or + followed by a space.

1. First item
2. Second item
3. Third item

Ordered lists use numbers followed by a period and space.

- Parent item
  - Nested item
    - Deeply nested
- Back to top level

Indent with two spaces to create nested lists.

- [x] Completed task
- [ ] Incomplete task
- [ ] Another todo

Task lists use - [ ] for incomplete and - [x] for completed items. Supported in GitHub-Flavored Markdown.


## Blockquotes

Blockquotes

> This is a blockquote.
> It can span multiple lines.

Prefix each line with > to create a blockquote. Often used for callouts or quoted text.

> Outer quote
>> Nested quote
>>> Even deeper

Stack > symbols to nest blockquotes inside each other.


## Code Blocks

Code blocks

Use `inline code` within a sentence.

Single backticks render inline code within a paragraph.

```
Plain code block
without syntax highlighting
```

Triple backticks on their own lines create a fenced code block.

```javascript
function hello() {
  console.log("Hello, world!");
}
```

Add a language name after the opening backticks to enable syntax highlighting. Common languages: javascript, python, bash, json, html, css, typescript, rust, go.


## Tables

Tables

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

Use pipes | to separate columns and hyphens --- for the header separator row.

| Left   | Center | Right  |
|:-------|:------:|-------:|
| data   | data   | data   |

Colons in the separator row control alignment. :--- left, :---: center, ---: right.


## Horizontal Rules

Horizontal rules

---

***

___

Three or more hyphens, asterisks, or underscores on their own line create a horizontal divider. All three produce the same result.


## GitHub-Flavored Extras

GitHub-Flavored extras

These extensions are supported by GitHub, many Markdown renderers, and ShowMeMyMD.

- [x] Design mockups
- [x] Write copy
- [ ] Ship it

Task lists render as interactive checkboxes on GitHub and in supported viewers.

> [!NOTE]
> Useful information that users should know.

A NOTE callout — renders as a blue info box in GitHub and ShowMeMyMD.

> [!TIP]
> Helpful advice for doing things better.

A TIP callout — renders as a green suggestion box.

> [!IMPORTANT]
> Key information users need to know.

An IMPORTANT callout — renders as a purple emphasis box.

> [!WARNING]
> Urgent info that needs immediate attention.

A WARNING callout — renders as a yellow alert box.

> [!CAUTION]
> Advises about risks or negative outcomes.

A CAUTION callout — renders as a red danger box.


## Keep reading


See all of this rendered beautifully

Open any .md file in ShowMeMyMD. Instant preview, syntax highlighting, and four themes. $2.99 on the Mac App Store.

Download on theMac App Store