Instantly share code, notes, and snippets.

Embed
What would you like to do?
A guide to Markdown on Discord.

Markdown Text 101

Want to inject some flavor into your everyday text chat? You're in luck! Discord uses Markdown, a simple plain text formatting system that'll help you make your sentences stand out. Here's how to do it! Just add a few characters before & after your desired text to change your text! I'll show you some examples...

Sweet Styles

Italics *italics* or _italics_

Underline italics __*underline italics*__

Bold **bold**

Underline bold __**underline bold**__

Bold Italics ***bold italics***

underline bold italics __***underline bold italics***__

Underline __underline__

Strikethrough ~~Strikethrough~~

Don't want to use markdown? You can slap a backslash in front of your statement, and it'll escape the markdown formatting. You'll see those asterisks as you'd like! Just keep in mind, it doesn't work in messages with edits or underscores.

Code Blocks

Discord also supports code blocks as well. You can make your own code blocks by wrapping your text in backticks (`)

one line code blocks

You can also use three backticks (```) to create multiline code blocks, like this beautifully written haiku.

multiline code blocks

Syntax Highlighting

If you really want to spruce up your code blocks, you can denote a specific language for syntax highlighting, by typing the name of the language you want the code block to expect right after the first three backticks beginning your code block. An example...

syntax highlighting

There are many different languages in place of Markdown that Discord's syntax highlighting support. Each different language has its own approach to highlight-able syntax. For a full list: https://highlightjs.org/static/demo/. Note that you won't be able to view syntax highlighting on the mobile app.

asciidoc

asciidoc

autohotkey

autohotkey

bash

bash

coffeescript

coffeescript

cpp (C++)

cpp

cs (C#)

cs

css

css

diff

diff

fix

fix

glsl

glsl

ini

ini

json

json

md (markdown)

md

ml

ml

prolog

prolog

py

py

tex

tex

xl

xl

xml

xml

And you get the idea! Now you're a Discord text markdown expert. Get out there and highlight your statements!

Acknowledgements

Hammer and Chisel
Discord Highlight.js

A special thanks to Frosty#9449 for their help in making this guide.

If you have any questions or want to get in contact with me, you can add Matthew#2334 on Discord or join my support server.

@Ryonez

This comment has been minimized.

Show comment
Hide comment
@Ryonez

Ryonez Oct 1, 2017

Thank you so much for this!

Ryonez commented Oct 1, 2017

Thank you so much for this!

@TheRaven81

This comment has been minimized.

Show comment
Hide comment
@TheRaven81

TheRaven81 Oct 6, 2017

If you want to use the asterisks for emphasis and not go italic or bold, you can add a backslash before them like this:
\*An asterisk wrapped phrase\* = *An asterisk wrapped phrase*

Note from Matthew: I've added this. Thanks!

TheRaven81 commented Oct 6, 2017

If you want to use the asterisks for emphasis and not go italic or bold, you can add a backslash before them like this:
\*An asterisk wrapped phrase\* = *An asterisk wrapped phrase*

Note from Matthew: I've added this. Thanks!

@Nesetalis

This comment has been minimized.

Show comment
Hide comment
@Nesetalis

Nesetalis Oct 24, 2017

single _ gives italics as well as single *.

Note from Matthew: I've added this. Thank you!

Nesetalis commented Oct 24, 2017

single _ gives italics as well as single *.

Note from Matthew: I've added this. Thank you!

@eltrhn

This comment has been minimized.

Show comment
Hide comment
@eltrhn

eltrhn Oct 29, 2017

Hmm, the tex highlighting seems to have changed -- can you confirm? This

```tex
Everything is highlighted```

produces

image

when I try it.

EDIT: thanks @troffaholic, it is indeed the $ :)

eltrhn commented Oct 29, 2017

Hmm, the tex highlighting seems to have changed -- can you confirm? This

```tex
Everything is highlighted```

produces

image

when I try it.

EDIT: thanks @troffaholic, it is indeed the $ :)

@troffaholic

This comment has been minimized.

Show comment
Hide comment
@troffaholic

troffaholic Oct 30, 2017

Notice the '$'.

troffaholic commented Oct 30, 2017

Notice the '$'.

@Tris10w

This comment has been minimized.

Show comment
Hide comment
@Tris10w

Tris10w Nov 6, 2017

Nicely done :)

Tris10w commented Nov 6, 2017

Nicely done :)

@AlexCSilva

This comment has been minimized.

Show comment
Hide comment
@AlexCSilva

AlexCSilva Nov 20, 2017

Great stuff :)

AlexCSilva commented Nov 20, 2017

Great stuff :)

@chevex

This comment has been minimized.

Show comment
Hide comment
@chevex

chevex Nov 26, 2017

Does Discord not support the standard Markdown quote blocks using >?

Like this:

> I am in a quote block.

I am in a quote block.


If it does support them I can't figure it out. If it doesn't, why not?

chevex commented Nov 26, 2017

Does Discord not support the standard Markdown quote blocks using >?

Like this:

> I am in a quote block.

I am in a quote block.


If it does support them I can't figure it out. If it doesn't, why not?

@KillyMXI

This comment has been minimized.

Show comment
Hide comment
@KillyMXI

KillyMXI Dec 6, 2017

I wonder why quoting is not available too. Only bots can emulate it to some extent. Humans usually replace it with code blocks.
Relevant suggestion: https://feedback.discordapp.com/forums/326712-discord-dream-land/suggestions/15536655-quoting

One more thing to add to this guide:
Links wrapped into angle brackets like this: <https://example.org> - will not show preview.

KillyMXI commented Dec 6, 2017

I wonder why quoting is not available too. Only bots can emulate it to some extent. Humans usually replace it with code blocks.
Relevant suggestion: https://feedback.discordapp.com/forums/326712-discord-dream-land/suggestions/15536655-quoting

One more thing to add to this guide:
Links wrapped into angle brackets like this: <https://example.org> - will not show preview.

@ILGVARSBOSS

This comment has been minimized.

Show comment
Hide comment
@ILGVARSBOSS

ILGVARSBOSS Dec 19, 2017

how do you do a link in code

ILGVARSBOSS commented Dec 19, 2017

how do you do a link in code

@Alipoodle

This comment has been minimized.

Show comment
Hide comment
@Alipoodle

Alipoodle Feb 21, 2018

Add
asciidoc

Orange  :: Plain

image

Note from Matthew: I've added this, thank you!

Alipoodle commented Feb 21, 2018

Add
asciidoc

Orange  :: Plain

image

Note from Matthew: I've added this, thank you!

@ghost

This comment has been minimized.

Show comment
Hide comment
@ghost

ghost Apr 9, 2018

thx bro

ghost commented Apr 9, 2018

thx bro

@ExoNarcis

This comment has been minimized.

Show comment
Hide comment
@ExoNarcis

ExoNarcis commented Apr 10, 2018

Add
Lua
IMG

@ghost

This comment has been minimized.

Show comment
Hide comment
@ghost

ghost Apr 11, 2018

Please add Tables, Bullet Points and Numbered Lists support
Thanks

ghost commented Apr 11, 2018

Please add Tables, Bullet Points and Numbered Lists support
Thanks

@ringmatthew

This comment has been minimized.

Show comment
Hide comment
@ringmatthew

ringmatthew Apr 13, 2018

Unfortunately, Discord doesn't support hyperlinks, quotes, tables, bullet points, or lists.

Owner

ringmatthew commented Apr 13, 2018

Unfortunately, Discord doesn't support hyperlinks, quotes, tables, bullet points, or lists.

@SHADOWELITE7

This comment has been minimized.

Show comment
Hide comment
@SHADOWELITE7

SHADOWELITE7 Apr 18, 2018

wow this is very helpfull

SHADOWELITE7 commented Apr 18, 2018

wow this is very helpfull

@SHADOWELITE7

This comment has been minimized.

Show comment
Hide comment
@SHADOWELITE7

SHADOWELITE7 Apr 18, 2018

hmm thought asciidoc would be colorful
https://prnt.sc/j6v75g

SHADOWELITE7 commented Apr 18, 2018

hmm thought asciidoc would be colorful
https://prnt.sc/j6v75g

@2wild4u

This comment has been minimized.

Show comment
Hide comment
@2wild4u

2wild4u Apr 19, 2018

how can i make the full text red with the - symbol in my text please

2wild4u commented Apr 19, 2018

how can i make the full text red with the - symbol in my text please

@ringmatthew

This comment has been minimized.

Show comment
Hide comment
@ringmatthew

ringmatthew Apr 20, 2018

@2wild4u See diff. Lines starting with - are red.

Owner

ringmatthew commented Apr 20, 2018

@2wild4u See diff. Lines starting with - are red.

@FridyGruder

This comment has been minimized.

Show comment
Hide comment
@FridyGruder

FridyGruder commented Apr 21, 2018

add
java
image

@DanielGGordon

This comment has been minimized.

Show comment
Hide comment
@DanielGGordon

DanielGGordon May 11, 2018

Why is there no support for quote blocks

Like this amazing quote here

Typed by Daniel Gordon, just now.

DanielGGordon commented May 11, 2018

Why is there no support for quote blocks

Like this amazing quote here

Typed by Daniel Gordon, just now.

@kylian001

This comment has been minimized.

Show comment
Hide comment
@kylian001

kylian001 May 12, 2018

Would be verry use full to use html for example

<font color="red">This is some text!</font>

This is some text! shut be red

kylian001 commented May 12, 2018

Would be verry use full to use html for example

<font color="red">This is some text!</font>

This is some text! shut be red

@darkwerehog

This comment has been minimized.

Show comment
Hide comment
@darkwerehog

darkwerehog May 16, 2018

alright i have a quick question I'm look all over the internet to find the syntax on how to get the color violet people say use ```markdown
[violet] like this but it keeps coming in grey can anyone fill me in on how to get the violet color and purple as well

darkwerehog commented May 16, 2018

alright i have a quick question I'm look all over the internet to find the syntax on how to get the color violet people say use ```markdown
[violet] like this but it keeps coming in grey can anyone fill me in on how to get the violet color and purple as well

@DVFlowey

This comment has been minimized.

Show comment
Hide comment
@DVFlowey

DVFlowey commented Jun 14, 2018

add LUA.

@DVFlowey

This comment has been minimized.

Show comment
Hide comment
@DVFlowey

DVFlowey Jun 14, 2018

image
^ i used a color changing tool, use that to make violet

DVFlowey commented Jun 14, 2018

image
^ i used a color changing tool, use that to make violet

@Elepahnt

This comment has been minimized.

Show comment
Hide comment
@Elepahnt

Elepahnt commented Jun 27, 2018

@Elepahnt

This comment has been minimized.

Show comment
Hide comment
@Elepahnt

Elepahnt commented Jun 27, 2018

how

@H336

This comment has been minimized.

Show comment
Hide comment
@H336

H336 Jul 2, 2018

image
Syntax: I will not say

H336 commented Jul 2, 2018

image
Syntax: I will not say

@Noahkiq

This comment has been minimized.

Show comment
Hide comment
@Noahkiq

Noahkiq Jul 5, 2018

Purple/violet is not part of the code block color palette and is not possible in Discord without using client mods to change the colors.

Noahkiq commented Jul 5, 2018

Purple/violet is not part of the code block color palette and is not possible in Discord without using client mods to change the colors.

@Noviian

This comment has been minimized.

Show comment
Hide comment
@Noviian

Noviian Jul 5, 2018

in prolog, any text after % on the same line will be dark grey
fdsf

Noviian commented Jul 5, 2018

in prolog, any text after % on the same line will be dark grey
fdsf

@flipthedog

This comment has been minimized.

Show comment
Hide comment
@flipthedog

flipthedog Jul 10, 2018

I am sad links don't work in discord :'(. Or am I missing something?

flipthedog commented Jul 10, 2018

I am sad links don't work in discord :'(. Or am I missing something?

@GlitchMasta47

This comment has been minimized.

Show comment
Hide comment
@GlitchMasta47

GlitchMasta47 Jul 21, 2018

Inline links aren't supported by users or even bots, only webhooks.
cc: @flipthedog

GlitchMasta47 commented Jul 21, 2018

Inline links aren't supported by users or even bots, only webhooks.
cc: @flipthedog

@ringmatthew

This comment has been minimized.

Show comment
Hide comment
@ringmatthew

ringmatthew Jul 23, 2018

@flipthedog @GlitchMasta47 Bots and webhooks can hyperlink things inside embeds.

Owner

ringmatthew commented Jul 23, 2018

@flipthedog @GlitchMasta47 Bots and webhooks can hyperlink things inside embeds.

@konatizer

This comment has been minimized.

Show comment
Hide comment
@konatizer

konatizer Jul 26, 2018

i noticed that with python syntax highlighting, you have to write "python" and not "py" as it says here.

konatizer commented Jul 26, 2018

i noticed that with python syntax highlighting, you have to write "python" and not "py" as it says here.

@swessey

This comment has been minimized.

Show comment
Hide comment
@swessey

swessey Jul 28, 2018

Thank you! This was more helpful than the real docs made by discord.

swessey commented Jul 28, 2018

Thank you! This was more helpful than the real docs made by discord.

@GlitchMasta47

This comment has been minimized.

Show comment
Hide comment
@GlitchMasta47

GlitchMasta47 Jul 28, 2018

@ringmatthew I know about that too, but I was specifically talking about inline links.

GlitchMasta47 commented Jul 28, 2018

@ringmatthew I know about that too, but I was specifically talking about inline links.

@SeymourSchlong

This comment has been minimized.

Show comment
Hide comment
@SeymourSchlong

SeymourSchlong Aug 7, 2018

If you leave a backslash before any of the characters used in markdown, you can keep your message with all of the markdown characters. This will work with underscores, asterisks, backticks, and tildes.

SeymourSchlong commented Aug 7, 2018

If you leave a backslash before any of the characters used in markdown, you can keep your message with all of the markdown characters. This will work with underscores, asterisks, backticks, and tildes.

@paulvanvulpen

This comment has been minimized.

Show comment
Hide comment
@paulvanvulpen

paulvanvulpen Aug 15, 2018

It seems clojure is also supported but missing from the list

paulvanvulpen commented Aug 15, 2018

It seems clojure is also supported but missing from the list

@JanLorem

This comment has been minimized.

Show comment
Hide comment
@JanLorem

JanLorem Aug 27, 2018

php is also supported

JanLorem commented Aug 27, 2018

php is also supported

@Gravitygrey

This comment has been minimized.

Show comment
Hide comment
@Gravitygrey

Gravitygrey Sep 21, 2018

yaml is supported also

yaml
yaml:
no-yaml

*works in discord

Gravitygrey commented Sep 21, 2018

yaml is supported also

yaml
yaml:
no-yaml

*works in discord

@Alpha-Knugen

This comment has been minimized.

Show comment
Hide comment
@Alpha-Knugen

Alpha-Knugen Sep 23, 2018

I dont know if im stupid or not but i can get colors on numbers with "python" but i want to get colors on everything but i cant use like python and css to color the text. am i doing wrong?

Alpha-Knugen commented Sep 23, 2018

I dont know if im stupid or not but i can get colors on numbers with "python" but i want to get colors on everything but i cant use like python and css to color the text. am i doing wrong?

@Alpha-Knugen

This comment has been minimized.

Show comment
Hide comment
@Alpha-Knugen

Alpha-Knugen Sep 23, 2018

I dont know if im stupid or not but i can get colors on numbers with "python" but i want to get colors on everything but i cant use like python and css to color the text. am i doing wrong?

i managed to get the text as i want it with xml but is it possible to not have <this in the start and end of the texts?>

Alpha-Knugen commented Sep 23, 2018

I dont know if im stupid or not but i can get colors on numbers with "python" but i want to get colors on everything but i cant use like python and css to color the text. am i doing wrong?

i managed to get the text as i want it with xml but is it possible to not have <this in the start and end of the texts?>

@speedking456

This comment has been minimized.

Show comment
Hide comment
@speedking456

speedking456 Sep 30, 2018

php, html, and mysql work too

I've tried all of these, reply with more and I'll add them if they work.
Full list
asciidoc
autohotkey
bash
coffeescript
cpp (C++)
cs (C#)
css
diff
fix
glsl
ini
json
md (markdown)
ml
prolog
py
tex
xl
xml
php
html

speedking456 commented Sep 30, 2018

php, html, and mysql work too

I've tried all of these, reply with more and I'll add them if they work.
Full list
asciidoc
autohotkey
bash
coffeescript
cpp (C++)
cs (C#)
css
diff
fix
glsl
ini
json
md (markdown)
ml
prolog
py
tex
xl
xml
php
html

@Priultimus

This comment has been minimized.

Show comment
Hide comment
@Priultimus

Priultimus Oct 5, 2018

I see no mention of javascript?

image

Priultimus commented Oct 5, 2018

I see no mention of javascript?

image

@aliasmask

This comment has been minimized.

Show comment
Hide comment
@aliasmask

aliasmask Oct 6, 2018

What's the syntax for using a certain style in your code block. For example, I would like to use HTML with the Vs 2015 style.

aliasmask commented Oct 6, 2018

What's the syntax for using a certain style in your code block. For example, I would like to use HTML with the Vs 2015 style.

@DanielGGordon

This comment has been minimized.

Show comment
Hide comment
@DanielGGordon

DanielGGordon Oct 9, 2018

Is there really no way to make a list or a blockquote in Discord???

DanielGGordon commented Oct 9, 2018

Is there really no way to make a list or a blockquote in Discord???

@Shrek5InTheatres2019

This comment has been minimized.

Show comment
Hide comment
@Shrek5InTheatres2019

Shrek5InTheatres2019 Oct 10, 2018

screen shot 2018-10-09 at 7 26 01 pm

brainf**k seems to work with either bf or brainfuck, unless it's just... discord styling it randomly

Shrek5InTheatres2019 commented Oct 10, 2018

screen shot 2018-10-09 at 7 26 01 pm

brainf**k seems to work with either bf or brainfuck, unless it's just... discord styling it randomly
@LartyHD

This comment has been minimized.

Show comment
Hide comment
@LartyHD

LartyHD Oct 17, 2018

php, html, and mysql work too

I've tried all of these, reply with more and I'll add them if they work.
Full list
asciidoc
autohotkey
bash
coffeescript
cpp (C++)
cs (C#)
css
diff
fix
glsl
ini
json
md (markdown)
ml
prolog
py
tex
xl
xml
php
html

What is with Kotlin?
unbenannt

LartyHD commented Oct 17, 2018

php, html, and mysql work too

I've tried all of these, reply with more and I'll add them if they work.
Full list
asciidoc
autohotkey
bash
coffeescript
cpp (C++)
cs (C#)
css
diff
fix
glsl
ini
json
md (markdown)
ml
prolog
py
tex
xl
xml
php
html

What is with Kotlin?
unbenannt

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment