From e3cd377c5d4cf9ae787b6c055770c4ce2a1d2c7a Mon Sep 17 00:00:00 2001 From: Suspense <64612795+AlmostSuspense@users.noreply.github.com> Date: Sat, 8 Nov 2025 11:37:20 +0100 Subject: [PATCH 1/2] improve message formatting docs --- discord/developers/docs/reference.mdx | 61 ++++++++++++++------------- 1 file changed, 32 insertions(+), 29 deletions(-) diff --git a/discord/developers/docs/reference.mdx b/discord/developers/docs/reference.mdx index 7c6741abe6..e1e52b2f84 100644 --- a/discord/developers/docs/reference.mdx +++ b/discord/developers/docs/reference.mdx @@ -267,27 +267,30 @@ Discord utilizes a subset of markdown for rendering message content on its clien **Formats** -| Type | Structure | Example | -|-------------------------|-----------------------|---------------------------------| -| User | `<@USER_ID>` | `<@80351110224678912>` | -| User \* | `<@!USER_ID>` | `<@!80351110224678912>` | -| Channel | `<#CHANNEL_ID>` | `<#103735883630395392>` | -| Role | `<@&ROLE_ID>` | `<@&165511591545143296>` | -| Slash Command \*\* | `` | `` | -| Standard Emoji | Unicode Characters | 🦶 | -| Custom Emoji | `<:NAME:ID>` | `<:mmLol:216154654256398347>` | -| Custom Emoji (Animated) | `` | `` | -| Unix Timestamp | `` | `` | -| Unix Timestamp (Styled) | `` | `` | -| Guild Navigation | `` | `` | +| Type | Structure | Example | +|--------------------------------------|------------------------------------------|--------------------------------------| +| User | `<@USER_ID>` | `<@80351110224678912>` | +| User * | `<@!USER_ID>` | `<@!80351110224678912>` | +| Channel | `<#CHANNEL_ID>` | `<#103735883630395392>` | +| Role | `<@&ROLE_ID>` | `<@&165511591545143296>` | +| Slash command | `` | `` | +| Slash command with subcommand | `` | `` | +| Slash command with subcommand group | `` | ``| +| Standard emoji | Unicode characters | 🪴 | +| Custom emoji | `<:NAME:ID>` | `<:mmLol:216154654256398347>` | +| Animated custom emoji | `` | `` | +| Unix timestamp | `` | `` | +| Styled unix timestamp | `` | `` | +| Guild navigation | `` | See below | -Using the markdown for either users, roles, or channels will usually mention the target(s) accordingly, but this can be suppressed using the `allowed_mentions` parameter when creating a message. Standard emoji are currently rendered using [Twemoji](https://github.com/jdecked/twemoji) for Desktop/Android and Apple's native emoji on iOS. -Timestamps are expressed in seconds and display the given timestamp in the user's timezone and locale. +Using the markdown for users or roles will mention the target(s), and notify them depending on the sender's permissions as well as the value of the `allowed_mentions` field when creating a message. +Standard emoji are currently rendered using [Twemoji](https://github.com/jdecked/twemoji) for Desktop and Android while iOS devices use Apple's native emoji set. -\* User mentions with an exclamation mark are deprecated and should be handled like any other user mention. +Timestamps are expressed in **seconds** and display the given timestamp in the user's timezone and locale. + +\* User mentions with an exclamation point are deprecated and should be handled like any other user mention. -\*\* Subcommands and subcommand groups can also be mentioned by using respectively `` and ``. **Timestamp Styles** @@ -301,7 +304,7 @@ Timestamps are expressed in seconds and display the given timestamp in the user' | F | Tuesday, April 20, 2021 at 16:20 | Full Date, Short Time | | s | 20/04/2021, 16:20 | Short Date, Short Time | | S | 20/04/2021, 16:20:30 | Short Date, Medium Time | -| R | 2 months ago | Relative Time | +| R | 4 years ago | Relative Time | \*default @@ -309,17 +312,17 @@ Timestamps are expressed in seconds and display the given timestamp in the user' Guild navigation types link to the corresponding resource in the current server. -| Type | Description | -|--------------|----------------------------------------------------------------------------------------------------------------| -| customize | Customize tab with the server's [onboarding prompts](/developers/docs/resources/guild#guild-onboarding-object) | -| browse | Browse Channels tab | -| guide | [Server Guide](https://support.discord.com/hc/en-us/articles/13497665141655) | -| linked-roles | [Linked Roles](https://support.discord.com/hc/en-us/articles/10388356626711) | -| linked-roles | Linked Role connection | +| Full Syntax | Linked Resource | +|----------------------|----------------------------------------------------------------------------------------------------------------| +| | Channel & Roles tab with [Onboarding prompts](/developers/docs/resources/guild#guild-onboarding-object) | +| | Browse Channels tab | +| | [Server Guide](https://support.discord.com/hc/en-us/articles/13497665141655) tab | +| | [Linked Roles](https://support.discord.com/hc/en-us/articles/10388356626711) tab | +| | Specific linked role, opening the connection modal on click (the second `id` is the role id) | ## Image Formatting -**Image Base Url** +**Image Base URL** ```bash https://cdn.discordapp.com/ @@ -376,7 +379,7 @@ Discord uses ids and hashes to render images in the client. These hashes can be \*\*\*\*\* For Custom Emoji, we highly recommend requesting emojis as WebP for maximum performance and compatibility. Emojis can be uploaded as JPEG, PNG, GIF, WebP, and AVIF formats. WebP and AVIF formats must be requested as WebP since they don't convert well to other formats. The Discord client uses WebP for all emojis displayed in-app. See the [Emoji Resource](/developers/docs/resources/emoji) page for more details. -Sticker GIFs do not use the CDN base url, and can be accessed at `https://media.discordapp.net/stickers/.gif`. +Sticker GIFs do not use the CDN base URL, and can be accessed at `https://media.discordapp.net/stickers/.gif`. ## Image Data @@ -542,9 +545,9 @@ For example: | bg | Bulgarian | български | | ru | Russian | Pусский | | uk | Ukrainian | Українська | -| hi | Hindi | हिन्दी | +| hi | Hindi | हिन्दी | | th | Thai | ไทย | | zh-CN | Chinese, China | 中文 | | ja | Japanese | 日本語 | | zh-TW | Chinese, Taiwan | 繁體中文 | -| ko | Korean | 한국어 | +| ko | Korean | 한국어 | From 44e871af82256c0fc10702958de1ba79acbe97dc Mon Sep 17 00:00:00 2001 From: Suspense Date: Sun, 9 Nov 2025 17:16:38 +0100 Subject: [PATCH 2/2] tables --- discord/developers/docs/reference.mdx | 48 +++++++++++++-------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/discord/developers/docs/reference.mdx b/discord/developers/docs/reference.mdx index e1e52b2f84..ef99f6950a 100644 --- a/discord/developers/docs/reference.mdx +++ b/discord/developers/docs/reference.mdx @@ -267,21 +267,21 @@ Discord utilizes a subset of markdown for rendering message content on its clien **Formats** -| Type | Structure | Example | -|--------------------------------------|------------------------------------------|--------------------------------------| -| User | `<@USER_ID>` | `<@80351110224678912>` | -| User * | `<@!USER_ID>` | `<@!80351110224678912>` | -| Channel | `<#CHANNEL_ID>` | `<#103735883630395392>` | -| Role | `<@&ROLE_ID>` | `<@&165511591545143296>` | -| Slash command | `` | `` | -| Slash command with subcommand | `` | `` | -| Slash command with subcommand group | `` | ``| -| Standard emoji | Unicode characters | 🪴 | -| Custom emoji | `<:NAME:ID>` | `<:mmLol:216154654256398347>` | -| Animated custom emoji | `` | `` | -| Unix timestamp | `` | `` | -| Styled unix timestamp | `` | `` | -| Guild navigation | `` | See below | +| Type | Structure | Example | +|-------------------------------------|------------------------------------------|---------------------------------------| +| User | `<@USER_ID>` | `<@80351110224678912>` | +| User * | `<@!USER_ID>` | `<@!80351110224678912>` | +| Channel | `<#CHANNEL_ID>` | `<#103735883630395392>` | +| Role | `<@&ROLE_ID>` | `<@&165511591545143296>` | +| Slash command | `` | `` | +| Slash command with subcommand | `` | `` | +| Slash command with subcommand group | `` | `` | +| Standard emoji | Unicode characters | 🪴 | +| Custom emoji | `<:NAME:ID>` | `<:mmLol:216154654256398347>` | +| Animated custom emoji | `` | `` | +| Unix timestamp | `` | `` | +| Styled unix timestamp | `` | `` | +| Guild navigation | `` | See below | Using the markdown for users or roles will mention the target(s), and notify them depending on the sender's permissions as well as the value of the `allowed_mentions` field when creating a message. @@ -312,13 +312,13 @@ Timestamps are expressed in **seconds** and display the given timestamp in the u Guild navigation types link to the corresponding resource in the current server. -| Full Syntax | Linked Resource | -|----------------------|----------------------------------------------------------------------------------------------------------------| -| | Channel & Roles tab with [Onboarding prompts](/developers/docs/resources/guild#guild-onboarding-object) | -| | Browse Channels tab | -| | [Server Guide](https://support.discord.com/hc/en-us/articles/13497665141655) tab | -| | [Linked Roles](https://support.discord.com/hc/en-us/articles/10388356626711) tab | -| | Specific linked role, opening the connection modal on click (the second `id` is the role id) | +| Full Syntax | Linked Resource | +|----------------------|---------------------------------------------------------------------------------------------------------| +| | Channel & Roles tab with [Onboarding prompts](/developers/docs/resources/guild#guild-onboarding-object) | +| | Browse Channels tab | +| | [Server Guide](https://support.discord.com/hc/en-us/articles/13497665141655) tab | +| | [Linked Roles](https://support.discord.com/hc/en-us/articles/10388356626711) tab | +| | Specific linked role, opening the connection modal on click (the second `id` is the role id) | ## Image Formatting @@ -545,9 +545,9 @@ For example: | bg | Bulgarian | български | | ru | Russian | Pусский | | uk | Ukrainian | Українська | -| hi | Hindi | हिन्दी | +| hi | Hindi | हिन्दी | | th | Thai | ไทย | | zh-CN | Chinese, China | 中文 | | ja | Japanese | 日本語 | | zh-TW | Chinese, Taiwan | 繁體中文 | -| ko | Korean | 한국어 | +| ko | Korean | 한국어 |