giggle-official/discord-markdown

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

| Style | Syntax | Example | |-------|--------|---------| | Italic | *text* or _text_ | italic | | Bold | **text** | bold | | Bold Italic | ***text*** | bold italic | | Underline | __text__ | | | Strikethrough | ~~text~~ | ~~strikethrough~~ | | Spoiler | \|\|text\|\| | (hidden until clicked) |

Combinations

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

Headers

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

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

Subtext

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

-# This appears as subtext

Code

Inline: `code`

Multi-line:

```
code block
multiple lines
```

With syntax highlighting:

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

Block Quotes

Single line (space required after >):

> This is a quote

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

>>> This is a
multi-line quote

Lists

Bulleted (space required after - or *):

- Item one
- Item two
* Also works

Indented (2 spaces before bullet):

- Parent
  - Child
  - Child

Numbered:

1. First
2. Second

Masked Links

[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)