discord-markdown
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.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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~~ |
|
| 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)
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-28
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!