Markdown Guide

Welcome to our shiny new forums! You’ll notice that the way post formatting works has changed, and this post will teach you all you need to know.

Headings

To use headings in your posts, use the # symbol at the beginning of the line. One # will make a Level 1 heading, and you can use up to 6 #s to make smaller headings.

View Example

Level 1

Level 2

Level 3

Level 4

Level 5
Level 6

Bold, Italics, Strikethrough

To make text bold, you can use the 𝐁 button in the editor bar, or surround text by two asterisks. Or you can use the keyboard shortcut CTRL+B.

Example: **Test** produces Test.

To make text italics, you can use the the 𝑰 button in the editor bar, or surround text by either an underscore or one asterisk. Or you can use the keyboard shortcut CTRL+I
Example: _Test_ or *Test* produces Test

To strikethrough text, type ~~ on either side of the text. There is currently no button to do this in the editor.
Example: ~~Test~~ becomes Test

Links

To add links, click the :link: button in the editor bar. Enter the URL you want to link to in the first box, and, if required, the text you want the link to say in the second box. If you don’t enter anything in the second box it will show the full link.

Example: [Project City Build](https://projectcitybuild.com) becomes Project City Build

Lists

To create a bulleted list, put an asterisk and a space in front of each line.

View Example
* A
* B
* C

produces

  • A
  • B
  • C

To create a numbered list, put the number and a space before each line.

View Example
1. One
2. Two
3. Three

produces

  1. One
  2. Two
  3. Three

To create nested lists, put three spaces before each list item within another list.

View Example

1. One
   - A
   - B
   - C
* D
   1. Some
   2. More
   3. Lists
      * Wow
      * Another
      * Level

produces

  1. One
    • A
    • B
    • C
  • D
    1. Some
    2. More
    3. Lists
      • Wow
      • Another
      • Level

Uploading Images

You can now upload images directly to your post without needing to use an image host like imgur. Click the upload icon in the post menu (third item in the second group). You can either select the image from your computer or if your image is already hosted somewhere, paste the URL.

Once your image has been uploaded, something like this will be inserted into your post:
![touchicon|200x200](upload://4usGoLt9zdClxMr1I51t8KGNP73.jpg)

You can adjust the size of your image by changing the 200x200 part to whatever dimensions you want.

Emoji :joy: :joy: :joy: :joy: :100:

You can now use Emoji in your posts. :roll_eyes:
Either directly type the code (e.g. :joy:) or use the emoji picker in the editor bar. You can also set the skin colour of some emoji using the picker at the bottom.
Full Unicode emoji list is available here: https://unicode.org/emoji/charts/full-emoji-list.html

Hide Details

Discourse doesn’t include spoiler tags, but it does include a very similar feature called ‘Hide Details’. To use it, select the text you’d like to hide, click the :gear: icon in the editor menu and click ‘Hide Details’. You can enter a custom caption between the quotes. This is what’s used for all the View Example links in this guide.

Spoiler Tags

To hide a section of text, you can use inline spoiler tags:
[spoiler]Shrek dies in Despacito 2[/spoiler]

It will look like this:

Shrek dies in Despacito 2

Click the blurry text to reveal the spoiler

3 Likes