# Markdown cheat sheet

**URL:** https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064
**Category:** General
**Created:** [November 19, 2017, 12:03pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064 "2017-11-19T12:03:46Z")
**Posts on this page:** 18
**Page:** 1

<div class="post-metadata">

### Author: ![Someone](https://avatars.discourse-cdn.com/v4/letter/s/b77776/32.png) [@Someone](https://forums.thimbleweedpark.com/u/Someone)
#### Post date: [November 19, 2017, 12:03pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/1 "2017-11-19T12:03:46Z")

</div>

As demanded in another thread, I’ll start here a short Markdown “cheat sheet” with some shortcuts you can use in your posts. Feel free to add stuff. 🙂

## 0. Introduction

Discourse changes some chars into formats. For example it turns the \* at the beginning of a new line/paragraph into a bullet list. If you would like to prevent Discourse from this, just put a backslash \ before the char, in the example: \* This leads to: \*. If you would like to print the backlash \, use two of them: \\

## 1. Fonts

This code:

```
Text attributes _italic_, *italic*, __bold__ , **bold** , 
`monospace/preformatted text`, ~~strikethrough~~

```

(note that there are two \_ before and after _bold_))

produces this:

Text attributes _italic_, _italic_, **bold** , **bold** ,  
`monospace/preformatted text`, ~~strikethrough~~

* * *

## 2. Paragraphs:

Two spaces at the end of a line (like in this one) leave a  
line break.

The lines of quotes are starting with `>`. So this:

`> This is a quote`

produces this output:

> This is a quote

* * *

## 3. Lists

This code:

```
Bullet list:
* Franklin
* Ransome
* Delores

Numbered list:
1. Franklin
2. Ransome
3. Delores

```

produces this:

Bullet list:

- Franklin
- Ransome
- Delores

Numbered list:

1. Franklin
2. Ransome
3. Delores

Notes:  
For bullet lists you can use + or - instead of \*.  
For numbered lists you can use parentheses instead of the dots:

```
Numbered list:
1) Franklin
2) Ransome
3) Delores

```

* * *

## 4. Links

This code:

`[Wikipedia article](https://en.wikipedia.org/wiki/Markdown)`

produces this:

[Wikipedia article](https://en.wikipedia.org/wiki/Markdown)

* * *

## 5. Lines

You can produce a line with and empty paragraph following three `-`. So this:

`---`

produces this:

* * *

## 6. Headings:

This code:

```
# Heading
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

## Sub-heading
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

### Sub-sub-heading
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

```

leads to this:

# Heading

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

## Sub-heading

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

### Sub-sub-heading

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

Note: You can use the following code as an alternative:

```
A heading
---

Another heading
===

```

* * *

## 7. Tables

This code:

```
| Country | Percent | Remark |
| -------------- |:-------:| ------:|
| United States | 30.3% | First |
| Germany | 20.1% | Second |
| United Kingdom | 11.5% | Third |

```

produces this result:

| Country | Percent | Remark |
| --- | --- | --- |
| United States | 30.3% | First |
| Germany | 20.1% | Second |
| United Kingdom | 11.5% | Third |

Note: In the second row:  
`|: --- :|` means: center the cell content  
`--- :|` means: align the cell content right

You can insert as much `-` and spaces as you like. This would be also valid:

```
| Country | Percent | Remark |
| --- |:---:| ---:|
| United States | 30.3% | First |
| Germany | 20.1% | Second |
| United Kingdom | 11.5% | Third |

```

* * *

## 8. Code blocks

This code with backticks:

````
```
var hello = "hello world";
print(hello);
```

````

produces this output:

```auto
var hello = "hello world";
print(hello);

```

Note: Discourse tries to recognize the programming language.

* * *

## 9. Shortcuts

If you enter an interrogation mark, several keyboard shortcuts are shown:

[![](https://canada1.discourse-cdn.com/flex030/uploads/thimbleweedpark/original/2X/6/67b8d4e4a297a67b277060ece3f30cc3f5f6ad89.jpg) ](https://canada1.discourse-cdn.com/flex030/uploads/thimbleweedpark/original/2X/6/67b8d4e4a297a67b277060ece3f30cc3f5f6ad89.jpg)

---

<div class="post-metadata">

### Author: ![Guga](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/guga/32/14476_2.png) [@Guga](https://forums.thimbleweedpark.com/u/Guga)
#### Post date: [November 19, 2017, 12:09pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/2 "2017-11-19T12:09:30Z")

</div>

> [@Someone](#):
>
> This code:
> 
> ```
> Bullet list:
> * Franklin
> * Ransome
> * Delores
> 
> Numbered list:
> * Franklin
> * Ransome
> * Delores
> 
> ```
> 
> produces this:
> 
> Bullet list:
> 
> - Franklin
> - Ransome
> - Delores
> 
> Numbered list:
> 
> - Franklin
> - Ransome
> - Delores

That doesn’t look numbered to me 😛

---

<div class="post-metadata">

### Author: ![Jupp](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/jupp/32/359_2.png) [@Jupp](https://forums.thimbleweedpark.com/u/Jupp)
#### Post date: [November 19, 2017, 12:11pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/3 "2017-11-19T12:11:46Z")

</div>

So I am not the only one.  
Putting on your magical nose glasses fixes this.  
8o)

---

<div class="post-metadata">

### Author: ![Someone](https://avatars.discourse-cdn.com/v4/letter/s/b77776/32.png) [@Someone](https://forums.thimbleweedpark.com/u/Someone)
#### Post date: [November 19, 2017, 12:23pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/4 "2017-11-19T12:23:14Z")

</div>

> [@Guga](#):
>
> That doesn’t look numbered to me 😛

Really? 😜

(Copy and paste is evil…)

---

<div class="post-metadata">

### Author: ![Guga](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/guga/32/14476_2.png) [@Guga](https://forums.thimbleweedpark.com/u/Guga)
#### Post date: [November 19, 2017, 12:24pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/5 "2017-11-19T12:24:54Z")

</div>

Numbered lists work also with parentheses 🙂

```
1) cacca
2) culo

```

gives

1. cacca
2. culo

---

<div class="post-metadata">

### Author: ![Someone](https://avatars.discourse-cdn.com/v4/letter/s/b77776/32.png) [@Someone](https://forums.thimbleweedpark.com/u/Someone)
#### Post date: [November 19, 2017, 12:28pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/6 "2017-11-19T12:28:58Z")

</div>

Thanks, I’ve added that!

Maybe @eviltrout can change the first post into a wiki post so that we all can add and change the cheat sheet?

---

<div class="post-metadata">

### Author: ![Sushi](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/sushi/32/163_2.png) [@Sushi](https://forums.thimbleweedpark.com/u/Sushi)
#### Post date: [November 19, 2017, 12:54pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/7 "2017-11-19T12:54:46Z")

</div>

> [@Someone](#):
>
> You can produce a line with three -. So this:
> 
> * * *

Just beware you have an empty line above the three -, otherwise you end up with a heading

---

<div class="post-metadata">

### Author: ![LowLevel](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/lowlevel/32/48_2.png) [@LowLevel](https://forums.thimbleweedpark.com/u/LowLevel)
#### Post date: [November 19, 2017, 1:08pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/8 "2017-11-19T13:08:10Z")

</div>

@Someone : thanks for creating the thread. 🙂

Would it be OK for you to change a bit the order of the contents so that at the top of the post we provide the syntax for the most used features in this forum (bold/italic, lists, other popular things usually obtained using the buttons in the toolbar of the writing window)?

In this way we would have a quick&easy top section useful to everybody and a more detailed section for those who want to discover the less used and technical features of MarkDown.

Also, would it be OK for you to mention a few useful keyboard shortcuts (without giving the full list of Discourse shortcuts)? When I create links, the CTRL-K shortcuts really makes the task super-fast for me.

> [@Someone](#):
>
> Maybe eviltrout can change the first post into a wiki post so that we all can add and change the cheat sheet?

You can do that yourself.

---

<div class="post-metadata">

### Author: ![Someone](https://avatars.discourse-cdn.com/v4/letter/s/b77776/32.png) [@Someone](https://forums.thimbleweedpark.com/u/Someone)
#### Post date: [November 19, 2017, 3:00pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/9 "2017-11-19T15:00:34Z")

</div>

> [@LowLevel](#):
>
> You can do that yourself.

Ah, yes. 🙂 I did that, so …

> [@LowLevel](#):
>
> Would it be OK for you to change a bit the order of the contents so that at the top of the post we provide the syntax for the most used features in this forum

… feel free to edit it. 🙂 Is it possible in Discourse to create a table of content at the beginning?

> [@LowLevel](#):
>
> Also, would it be OK for you to mention a few useful keyboard shortcuts (without giving the full list of Discourse shortcuts)?

Should we start a new thread with some shortcuts and/or the BBcode? I wasn’t sure if I should add some BBcode-tags like `[details="..."]` …

---

<div class="post-metadata">

### Author: ![BigRedButton](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/bigredbutton/32/212_2.png) [@BigRedButton](https://forums.thimbleweedpark.com/u/BigRedButton)
#### Post date: [November 20, 2017, 8:12pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/10 "2017-11-20T20:12:27Z")

</div>

If you enter an interrogation mark, several keyboard shortcuts are shown:

 ![keyboard short-cuts](https://canada1.discourse-cdn.com/flex030/uploads/thimbleweedpark/original/2X/6/67b8d4e4a297a67b277060ece3f30cc3f5f6ad89.jpg)

---

<div class="post-metadata">

### Author: ![Calypso](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/calypso/32/3507_2.png) [@Calypso](https://forums.thimbleweedpark.com/u/Calypso)
#### Post date: [March 26, 2018, 1:34pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/11 "2018-03-26T13:34:30Z")

</div>



---

<div class="post-metadata">

### Author: ![Gffp](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/gffp/32/12183_2.png) [@Gffp](https://forums.thimbleweedpark.com/u/Gffp)
#### Post date: [April 29, 2018, 2:44pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/12 "2018-04-29T14:44:29Z")

</div>

> [@Someone](#):
>
> ~~strikethrough~~

Which keys on keyboard do you use to display these:  
~~

?

---

<div class="post-metadata">

### Author: ![Someone](https://avatars.discourse-cdn.com/v4/letter/s/b77776/32.png) [@Someone](https://forums.thimbleweedpark.com/u/Someone)
#### Post date: [April 29, 2018, 2:47pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/13 "2018-04-29T14:47:05Z")

</div>

> [@Gffp](#):
>
> > [@Someone](#):
> >
> > ~~strikethrough~~
> 
> Which keys on keyboard do you use to display these:  
> ~~
> 
> ?

Depends on your keyboad layout. On a German keyboard I have to press [Alt gr]+[+]  
([Alt gr] is the right Alt key)

---

<div class="post-metadata">

### Author: ![Gffp](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/gffp/32/12183_2.png) [@Gffp](https://forums.thimbleweedpark.com/u/Gffp)
#### Post date: [April 29, 2018, 2:51pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/14 "2018-04-29T14:51:00Z")

</div>

😑 Yeah, thanks, [Alt gr] is the same on italian layout, but the combination doesn’t work and still I don’t see any symbol like that… Maybe you know its name? Or if there are other ways to obtain the same result? Every time I want to do that I need to copy those wave-like characters from here.

---

<div class="post-metadata">

### Author: ![Someone](https://avatars.discourse-cdn.com/v4/letter/s/b77776/32.png) [@Someone](https://forums.thimbleweedpark.com/u/Someone)
#### Post date: [April 29, 2018, 3:08pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/15 "2018-04-29T15:08:23Z")

</div>

The character is called “Tilde” and it seems that it is not available on a _standard_ Italian layout. Maybe these pages are helping:

> <https://superuser.com/questions/667622/italian-keyboard-entering-the-tilde-and-backtick-characters-without-cha>

> <https://superuser.com/questions/521155/how-to-type-the-tilde-character-that-is-not-in-my-keyboard-layout>

---

<div class="post-metadata">

### Author: ![ZakPhoenixMcKracken](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/zakphoenixmckracken/32/41_2.png) [@ZakPhoenixMcKracken](https://forums.thimbleweedpark.com/u/ZakPhoenixMcKracken)
#### Post date: [April 29, 2018, 8:58pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/16 "2018-04-29T20:58:16Z")

</div>

It’s tilde. To get it on every keyboard, press and hold the ALT key, then type 126 on the **numeric keypad** (not on the first row of the main keyboard). Then release the ALT key and you will see your tilde character.

---

<div class="post-metadata">

### Author: ![PiecesOfKate](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/piecesofkate/32/93_2.png) [@PiecesOfKate](https://forums.thimbleweedpark.com/u/PiecesOfKate)
#### Post date: [April 30, 2018, 9:51am UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/17 "2018-04-30T09:51:50Z")

</div>

> [@ZakPhoenixMcKracken](#):
>
> To get it on every keyboard

Apart from those that don’t have a numeric keypad 😛

---

<div class="post-metadata">

### Author: ![Guga](https://yyz2.discourse-cdn.com/flex030/user_avatar/forums.thimbleweedpark.com/guga/32/14476_2.png) [@Guga](https://forums.thimbleweedpark.com/u/Guga)
#### Post date: [April 30, 2018, 12:31pm UTC](https://forums.thimbleweedpark.com/t/markdown-cheat-sheet/2064/18 "2018-04-30T12:31:58Z")

</div>

> [@PiecesOfKate](#):
>
> Apart from those that don’t have a numeric keypad

We have a word for those.

Losers. 😈
