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.

Ryonez commented Oct 1, 2017

Thank you so much for this!

@TheRaven81

This comment has been minimized.

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.

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.

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.

troffaholic commented Oct 30, 2017

Notice the '$'.

@Tris10w

This comment has been minimized.

Tris10w commented Nov 6, 2017

Nicely done :)

@AlexCSilva

This comment has been minimized.

AlexCSilva commented Nov 20, 2017

Great stuff :)

@chevex

This comment has been minimized.

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.

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.

ILGVARSBOSS commented Dec 19, 2017

how do you do a link in code

@Alipoodle

This comment has been minimized.

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.

ghost commented Apr 9, 2018

thx bro

@ExoNarcis

This comment has been minimized.

ExoNarcis commented Apr 10, 2018

Add
Lua
IMG

@ghost

This comment has been minimized.

ghost commented Apr 11, 2018

Please add Tables, Bullet Points and Numbered Lists support
Thanks

@ringmatthew

This comment has been minimized.

Owner

ringmatthew commented Apr 13, 2018

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

@SHADOWELITE7

This comment has been minimized.

SHADOWELITE7 commented Apr 18, 2018

wow this is very helpfull

@SHADOWELITE7

This comment has been minimized.

SHADOWELITE7 commented Apr 18, 2018

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

@2wild4u

This comment has been minimized.

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.

Owner

ringmatthew commented Apr 20, 2018

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

@FridyGruder

This comment has been minimized.

FridyGruder commented Apr 21, 2018

add
java
image

@DanielGGordon

This comment has been minimized.

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.

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.

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.

DVFlowey commented Jun 14, 2018

add LUA.

@DVFlowey

This comment has been minimized.

DVFlowey commented Jun 14, 2018

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

@Elepahnt

This comment has been minimized.

Elepahnt commented Jun 27, 2018

@Elepahnt

This comment has been minimized.

Elepahnt commented Jun 27, 2018

how

@H336

This comment has been minimized.

H336 commented Jul 2, 2018

image
Syntax: I will not say

@Noahkiq

This comment has been minimized.

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.

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.

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.

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.

Owner

ringmatthew commented Jul 23, 2018

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

@konatizer

This comment has been minimized.

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.

swessey commented Jul 28, 2018

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

@GlitchMasta47

This comment has been minimized.

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.

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.

paulvanvulpen commented Aug 15, 2018

It seems clojure is also supported but missing from the list

@JanLorem

This comment has been minimized.

JanLorem commented Aug 27, 2018

php is also supported

@Gravitygrey

This comment has been minimized.

Gravitygrey commented Sep 21, 2018

yaml is supported also

yaml
yaml:
no-yaml

*works in discord

@Alpha-Knugen

This comment has been minimized.

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.

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.

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.

Priultimus commented Oct 5, 2018

I see no mention of javascript?

image

@aliasmask

This comment has been minimized.

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.

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.

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.

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

@Kyrela

This comment has been minimized.

Kyrela commented Oct 26, 2018

image
You forgot to mention that by linking between > and < (upside down), you prevent its preview!
image

@WhiteWolf-One

This comment has been minimized.

WhiteWolf-One commented Oct 27, 2018

Direct embeds? Or only via webhook?

FYI: https://discord.club/tools/embed-generator

  • could be useful.
@Almeeida

This comment has been minimized.

Almeeida commented Nov 8, 2018

there's also a
yaml

@dcorvus

This comment has been minimized.

dcorvus commented Nov 18, 2018

Don't forget you can also do ``This is text`` so you can escape other ` inside.

This is a test ` of this ` code block.

@Bluscream

This comment has been minimized.

Bluscream commented Nov 26, 2018

List of languages: https://github.com/highlightjs/highlight.js/tree/master/src/languages

langs = ["1c","abnf","accesslog","actionscript","ada","angelscript","apache","applescript","arcade","arduino","armasm","asciidoc","aspectj","autohotkey","autoit","avrasm","awk","axapta","bash","basic","bnf","brainfuck","cal","capnproto","ceylon","clean","clojure","clojure-repl","cmake","coffeescript","coq","cos","cpp","crmsh","crystal","cs","csp","css","d","dart","delphi","diff","django","dns","dockerfile","dos","dsconfig","dts","dust","ebnf","elixir","elm","erb","erlang","erlang-repl","excel","fix","flix","fortran","fsharp","gams","gauss","gcode","gherkin","glsl","gml","go","golo","gradle","groovy","haml","handlebars","haskell","haxe","hsp","htmlbars","http","hy","inform7","ini","irpf90","isbl","java","javascript","jboss-cli","json","julia","julia-repl","kotlin","lasso","ldif","leaf","less","lisp","livecodeserver","livescript","llvm","lsl","lua","makefile","markdown","mathematica","matlab","maxima","mel","mercury","mipsasm","mizar","mojolicious","monkey","moonscript","n1ql","nginx","nimrod","nix","nsis","objectivec","ocaml","openscad","oxygene","parser3","perl","pf","pgsql","php","plaintext","pony","powershell","processing","profile","prolog","properties","protobuf","puppet","purebasic","python","q","qml","r","reasonml","rib","roboconf","routeros","rsl","ruby","ruleslanguage","rust","sas","scala","scheme","scilab","scss","shell","smali","smalltalk","sml","sqf","sql","stan","stata","step21","stylus","subunit","swift","taggerscript","tap","tcl","tex","thrift","tp","twig","typescript","vala","vbnet","vbscript","vbscript-html","verilog","vhdl","vim","x86asm","xl","xml","xquery","yaml","zephir"]
text = " ".join(arguments)
_text = ""
for lang in langs:
_text += "{0}:\n```{0}\n{1}\n```\n".format(lang, text)
await message.channel.send(_text)
@Bluscream

This comment has been minimized.

Bluscream commented Nov 26, 2018

2018-11-26_20-47-59

@iRinku

This comment has been minimized.

iRinku commented Dec 12, 2018

javascript or php isn't supported in the markdown?

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