Skip to main content

Markdown syntax cheatsheet

Use the following table with a concise overview of the essential Markdown elements to enhance your content.

Table 1.

Element

Markdown syntax

Result

Heading

# Header 1
## Header 2
### Header 3
headers.png

Bold text

**bold** __bold__
markdown_phrase_emphasis_bold_italic.png

Italic text

*italic* _italic_

Ordered list

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

Unordered list

- First item
- Second item
- Third item
unordered_list.png

Nested list

Things I need to do today:
1. Fix usability problem
2. Clean up the page
   * Make the headings bigger
2. Push my changes
3. Create code review
   * Describe my changes
   * Assign reviewers
     * Ask for feedback
nested_list.png

Inline link

[data.world](https://data.world/)

data.world

Reference link

An [example][id]. Then, anywhere
else in the doc, define the link.

[id]: http://example.com/
reference_link.png

Inline image

![logo](https://www.example.com/logo.png)
markdown_images.png

Reference image

![logo][id]

[id]: /url/to/img.jpg

To-do list

* [ ] This is an unchecked TODO item
* [x] This is a completed TODO item
markdown_todo_lists.png

Blockquote

> # The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
>  *Everything* is going according to **plan**.
markdown_elements_blockquotes.png

Code spans

We have `<code>` included.
Back-ticks within `` `<code>` `` included.
markdown_code_spans.png
markdown_code_spans_with_backticks.png

Code blocks

This is a normal paragraph.

    this is a code
    block
```
Code goes here
```
markdown_intended_code_block.png
markdown_backticked_code_block.png

Horizontal rules

Paragraph 1.
* * *
Paragraph 2.
- - - -
markdown_insert_horizontal_rules.png

Line breaks

Roses are red,••
Violets are blue.

(where • is a space)

markdown_manual_line_breaks.png

Table

| Column 1 | Column 2 |
|----------|----------|
| value 11 | value 21 |
| value 12 | value 22 |
| value 13 | value 23 |
markdown_tables.png

Embed content

Explore this video:
@(https://www.youtube.com/watch?v=p56ZSngPjCM)
markdown_embed_content_inline_preview.png

Embed Vega and Vega-lite

@[vega-lite](https://query.data.world/s/uvj74s?dws=0)
@[vega](https://query.data.world/s/uvwdf4s?dws=0)
```vega
{
  /* ... vega source code ... */
}
```
markdown_vega_inline_code.png

Embed math formulas (MathJax)

When $a \ne 0$, there are two
solutions to \(ax^2 + bx + c = 0\).
$$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$$
markdown_mathjax_inline_formulas.png
markdown_block_formulas.png