From 59e7bcb2ea441bb02e48c0886aee551efd66184b Mon Sep 17 00:00:00 2001 From: ManHat Date: Wed, 2 Jul 2025 02:23:05 +0300 Subject: [PATCH 1/5] add phone, email; add timestamp footnote --- docs/reference.mdx | 38 +++++++++++++++++++++----------------- 1 file changed, 21 insertions(+), 17 deletions(-) diff --git a/docs/reference.mdx b/docs/reference.mdx index 0d7503e6b9..5047644c47 100644 --- a/docs/reference.mdx +++ b/docs/reference.mdx @@ -259,28 +259,32 @@ 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 | `` | `` | - -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. +| 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 | `` | `` | +| Email \*\*\*\* | `` | `` | +| Phone Number \*\*\*\* | `<+PHONE_NUMBER>` | `<+1 (555) 123 4567>` | + +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`](/docs/resources/message#message-object) 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. \* User mentions with an exclamation mark are deprecated and should be handled like any other user mention. \*\* Subcommands and subcommand groups can also be mentioned by using respectively `` and ``. +\*\*\* Timestamps are expressed in seconds and display the given timestamp in the user's timezone and locale. + +\*\*\*\* Email and phone number markdown will open the `mailto:` and `tel:` URL protocols respectively. + ###### Timestamp Styles | Style | Example Output | Description | From b17fe7d58ac5b0cd2b4882d552d9bf086a696134 Mon Sep 17 00:00:00 2001 From: ManHat Date: Wed, 2 Jul 2025 02:23:19 +0300 Subject: [PATCH 2/5] improve timestamp style footnote --- docs/reference.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference.mdx b/docs/reference.mdx index 5047644c47..95b4dbb0e2 100644 --- a/docs/reference.mdx +++ b/docs/reference.mdx @@ -297,7 +297,7 @@ Using the markdown for either users, roles, or channels will usually mention the | F | Tuesday, 20 April 2021 16:20 | Long Date/Time | | R | 2 months ago | Relative Time | -\*default +\* Default style used when no style is specified. ###### Guild Navigation Types From 3f04b58d535f130789332305435379a08545da68 Mon Sep 17 00:00:00 2001 From: ManHat Date: Wed, 2 Jul 2025 02:44:15 +0300 Subject: [PATCH 3/5] more details in footnote --- docs/reference.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference.mdx b/docs/reference.mdx index 95b4dbb0e2..bb07a8c481 100644 --- a/docs/reference.mdx +++ b/docs/reference.mdx @@ -283,7 +283,7 @@ Using the markdown for either users, roles, or channels will usually mention the \*\*\* Timestamps are expressed in seconds and display the given timestamp in the user's timezone and locale. -\*\*\*\* Email and phone number markdown will open the `mailto:` and `tel:` URL protocols respectively. +\*\*\*\* Email and phone number markdown will open the `mailto:` and `tel:` URL protocols respectively. Markdown can optionally be prefixed by a protocol (e.g. ``). Email markdown supports headers, values must be [URL Encoded](https://en.wikipedia.org/wiki/Percent-encoding) (e.g. ``). ###### Timestamp Styles From ca6d9d09a741cef94582b335bb094c69d9b728a5 Mon Sep 17 00:00:00 2001 From: ManHat Date: Wed, 2 Jul 2025 02:57:28 +0300 Subject: [PATCH 4/5] URIs not URLs --- docs/reference.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference.mdx b/docs/reference.mdx index bb07a8c481..6f75cb4463 100644 --- a/docs/reference.mdx +++ b/docs/reference.mdx @@ -283,7 +283,7 @@ Using the markdown for either users, roles, or channels will usually mention the \*\*\* Timestamps are expressed in seconds and display the given timestamp in the user's timezone and locale. -\*\*\*\* Email and phone number markdown will open the `mailto:` and `tel:` URL protocols respectively. Markdown can optionally be prefixed by a protocol (e.g. ``). Email markdown supports headers, values must be [URL Encoded](https://en.wikipedia.org/wiki/Percent-encoding) (e.g. ``). +\*\*\*\* Email and phone number markdown will open `mailto:` and `tel:` URI schemes respectively. Markdown can optionally be prefixed by a scheme (e.g. ``). Email markdown supports headers, values must be [URL Encoded](https://en.wikipedia.org/wiki/Percent-encoding) (e.g. ``). ###### Timestamp Styles From ac5b9c687c0b5f4137be2375720461582fc37c01 Mon Sep 17 00:00:00 2001 From: ManHat Date: Wed, 2 Jul 2025 03:08:53 +0300 Subject: [PATCH 5/5] reword --- docs/reference.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference.mdx b/docs/reference.mdx index 6f75cb4463..90898ebe97 100644 --- a/docs/reference.mdx +++ b/docs/reference.mdx @@ -283,7 +283,7 @@ Using the markdown for either users, roles, or channels will usually mention the \*\*\* Timestamps are expressed in seconds and display the given timestamp in the user's timezone and locale. -\*\*\*\* Email and phone number markdown will open `mailto:` and `tel:` URI schemes respectively. Markdown can optionally be prefixed by a scheme (e.g. ``). Email markdown supports headers, values must be [URL Encoded](https://en.wikipedia.org/wiki/Percent-encoding) (e.g. ``). +\*\*\*\* Email and phone number markdown uses `mailto:` and `tel:` URI schemes respectively that can optionally be prefixed (e.g. ``). Email markdown supports headers, values must be [URL Encoded](https://en.wikipedia.org/wiki/Percent-encoding) (e.g. ``). ###### Timestamp Styles