Message Formatting#

Discord utilizes a subset of markdown for rendering message content on its clients, while also adding some functionality to enable things like mentioning users and channels.

Formats#

Type	Structure
User	`<@USER_ID>`
Channel	`<#CHANNEL_ID>`
Role	`<@&ROLE_ID>`
Game profile	`<@$GAME_ID>`
Slash command	`</NAME:COMMAND_ID>`
Slash command with subcommand	`</NAME SUBCOMMAND:ID>`
Slash command with subcommand group	`</NAME SUBCOMMAND_GROUP SUBCOMMAND:ID>`
Standard emoji	Unicode characters
Custom emoji	`<:NAME:ID>`
Animated custom emoji	`<a:NAME:ID>`
Unix timestamp	`<t:TIMESTAMP>`
Styled unix timestamp	`<t:TIMESTAMP:STYLE>`
Guild navigation	`<id:TYPE>`

Using the markdown for users or roles will mention the target(s), and notify them depending on the sender’s permissions. Standard emoji are currently rendered using Twemoji for Desktop and Android while iOS and devices use Apple’s native emoji set.

Timestamps are expressed in seconds and display the given timestamp in the user’s timezone and locale.

Timestamp Styles#

Style	Description	Example Output
t	Short time	`16:20`
T	Medium time	`16:20:30`
d	Short date	`20/04/2021`
D	Long date	`April 20, 2021`
f (default)	Long date, short time	`April 20, 2021 at 16:20`
F	Full date, short time	`Tuesday, April 20, 2021 at 16:20`
s	Short date, short time	`20/04/2021, 16:20`
S	Short date, medium time	`20/04/2021, 16:20:30`
R	Relative time	`4 years ago`

Guild Navigation Types#

Guild navigation types link to the corresponding resource in the current server.

Full Syntax	Linked Resource
`<id:customize>`	Channel & Roles tab with Onboarding prompts
`<id:browse>`	Browse Channels tab
`<id:guide>`	Server Guide tab
`<id:linked-roles>`	Linked Roles tab
`<id:linked-roles:ID>`	Specific linked role, opening the connection modal on click