---

name: discord-markdown description: >- Discord-specific markdown syntax for formatting message strings. Use when constructing strings that will be sent as Discord messages, including: text formatting (bold, italic, underline, strikethrough, spoilers), headers, subtext, code blocks, block quotes, lists, and masked links.

Discord Markdown

Discord uses a variant of Markdown with some unique syntax. Key differences from standard Markdown:

• Underline: __text__ (not standard)
• Spoilers: ||text||
• Subtext: -# text
• Combinations like underline+bold+italic

Text Formatting

Combinations

Copy__*underline italic*__
__**underline bold**__
__***underline bold italic***__

Headers

Require a space after #. Must be at line start.

Copy# Large Header
## Medium Header
### Small Header

Subtext

Small, subdued text. Requires space after -#. Must be at line start.

Copy-# This appears as subtext

Code

Inline: `code`

Multi-line:

Copy```
code block
multiple lines
```

With syntax highlighting:

Copy```python
print("hello")
```

Block Quotes

Single line (space required after >):

Copy> This is a quote

Multi-line (everything after >>> is quoted):

Copy>>> This is a
multi-line quote

Lists

Bulleted (space required after - or *):

Copy- Item one
- Item two
* Also works

Indented (2 spaces before bullet):

Copy- Parent
  - Child
  - Child

Numbered:

Copy1. First
2. Second

Masked Links

Copy[Click here](https://example.com)

Common Patterns

Formatted user mention: <@user_id> Formatted channel: <#channel_id> Formatted role: <@&role_id> Custom emoji: <:name:id> or <a:name:id> (animated) Timestamp: <t:unix_timestamp:format>

Timestamp formats: t (short time), T (long time), d (short date), D (long date), f (short datetime), F (long datetime), R (relative)