Discord Small Text and Big Text: Subtext (-#) and Headers (#)
Start a line with -# and a space for small grey text on Discord. Start it with #, ## or ### for big text. Rules, combinations, why it sometimes shows as plain text, and options for names and bios.
Discord has one way to make text smaller and three sizes of bigger text. All four are prefixes at the start of a line:
# Big text
## Medium text
### Slightly big text
Normal text
-# Small text
Both features are described in Discord's Markdown Text 101 help article. Discord calls the small one subtext and the big ones headers.
Small text: -#
Type a hyphen, a pound sign and a space, then your text:
-# Posted on behalf of the mod team
The line renders smaller than normal chat text and in a dimmer grey.
Rules from Discord's article:
- The
-#must be at the very beginning of the line. It does not work in the middle of a sentence. - There must be a space after the
#. - It applies to the whole line. The next line is normal size again unless it also starts with
-#.
So you cannot shrink one word inside a sentence. This does not work:
The price is $40 -# plus tax
Put the small part on its own line instead:
The price is $40
-# plus tax, shipping not included
What people use subtext for
| Use | Example |
|---|---|
| Footnotes and disclaimers | -# Prices in USD. Subject to change. |
| Sources | -# Source: patch notes 4.2 |
| Edit notes | -# Edited to fix the date |
| Bot and announcement footers | -# Sent by EventBot. React to subscribe. |
| Quiet asides | -# (yes, I know this is the third reminder) |
Formatting inside subtext
Other inline formatting works inside a subtext line:
-# **Note:** times are shown in *your* timezone
-# Read the [full rules](https://example.com/rules)
-# Ends <t:1796148000:R>
-# ||small spoiler||
Bold, italic, underline, strikethrough, masked links, spoilers and timestamps all combine with it. What does not combine is another line prefix: a line is either subtext, a header, a quote or a list item.
Big text: #, ##, ###
Start a line with one, two or three pound signs and a space:
# Server rules
## 1. Be kind
### Details
| Prefix | Size |
|---|---|
# |
Biggest |
## |
Smaller |
### |
Smallest header, a little larger and bolder than normal text |
Discord's note on headers: do not forget the space between the # and your text, and the # has to be the first character on a new line. Four or more pound signs (####) are not a header and show as plain text.
There is no size above #. If you see letters bigger than that in a server, it is an image or an emoji, not text formatting.
When it shows as plain text
| What you typed | What went wrong | Fix |
|---|---|---|
-#small or #Big |
No space after the # |
-# small, # Big |
Hello -# small |
Prefix is not at the start of the line | Move it to a new line (Shift + Enter on desktop) |
-# small with a leading space |
Something comes before the prefix | Delete the leading space |
- # small |
Space between the hyphen and the pound sign, so it is a list item | Remove that space |
#### Title |
Only three header levels exist | Use ###, or **bold** for a fourth level |
-# small inside a code block |
Code blocks show everything literally | Move it out of the backticks |
#general turned into a channel link |
With no space, Discord offers matching channels and inserts a channel mention | Add the space: # general |
To show the characters without triggering the formatting, put a backslash first: \# not a header, \-# not subtext.
You can check a message before sending it in the Discord Text Formatter, which previews headers and subtext and warns about ####.
Small or big text in names, bios and status
Headers and subtext are message formatting. A nickname, channel name or server name shows # and -# as typed.
For those places the only option is Unicode look-alike characters, which are separate letters that happen to look small or bold:
| Want | Tool | Example |
|---|---|---|
| Small caps, superscript or subscript letters | Small Text Generator | ꜱᴍᴀʟʟ ᴄᴀᴘꜱ, ˢᵘᵖᵉʳˢᶜʳⁱᵖᵗ |
| Bold letters | Bold Text Generator | 𝗯𝗼𝗹𝗱 |
These are not real formatting. Search will not find a name written this way, some devices show boxes for missing letters, and screen readers may spell them out or skip them. In messages, prefer -# and #.
Small text on other platforms
Discord's -# is its own invention. Standard Markdown has no size syntax at all.
| Platform | Small text |
|---|---|
| Discord | -# text |
| GitHub | <sub>text</sub> or <sup>text</sup> |
| Websites and docs | <small>text</small> |
| Slack, WhatsApp | No size control |
More in small text in Markdown.