How to format text in Discord
- Type in Message, or tap Insert example to see several tricks at once.
- Select a word or a few lines.
- Tap a button such as Bold or Spoiler, or press Ctrl+B or Ctrl+I (⌘ on a Mac).
- Check the Preview, then tap Copy and paste into Discord.
Discord’s help centre says it uses Markdown, and the developer docs call it “a subset of markdown”: a small set of symbols that Discord turns into formatting when you send. Tap a button a second time to take its symbols off again.
Discord markdown cheat sheet
| Rule | Type | Result | Source |
|---|---|---|---|
| Italics | *italics* | italics | Markdown Text 101 |
| Italics (underscores) | _italics_ | italics | Markdown Text 101 |
| Bold | **bold** | bold | Markdown Text 101 |
| Bold italics | ***bold italics*** | bold italics | Markdown Text 101 |
| Underline | __underline__ | underline | Markdown Text 101 |
| Underline italics | __*underline italics*__ | underline italics | Markdown Text 101 |
| Underline bold | __**underline bold**__ | underline bold | Markdown Text 101 |
| Underline bold italics | __***underline bold italics***__ | underline bold italics | Markdown Text 101 |
| Strikethrough | ~~strikethrough~~ |
| Markdown Text 101 |
| Spoiler | ||spoiler|| | spoiler | Spoiler Tags |
| Heading 1 | # Heading 1 | Heading 1 | Markdown Text 101 |
| Heading 2 | ## Heading 2 | Heading 2 | Markdown Text 101 |
| Heading 3 | ### Heading 3 | Heading 3 | Markdown Text 101 |
| Subtext | -# subtext | subtext | Markdown Text 101 |
| Masked link | [text](https://example.com) | text | Markdown Text 101 |
| Bulleted list | - item |
| Markdown Text 101 |
| Numbered list | 1. item |
| Markdown Text 101 |
| Inline code | `code` |
| Markdown Text 101 |
| Code block | ```code``` | | Markdown Text 101 |
| Code language | ```js | | Not in Discord’s guide — not tested yet |
| Colour text | ```ansi + ESC codes | | Not in Discord’s guide — not tested yet |
| Quote | > quote |
| Markdown Text 101 |
| Block quote | >>> block quote |
| Markdown Text 101 |
| Escape a symbol | \* | *not italic* | Not in Discord’s guide — not tested yet |
| Timestamp | <t:1767225600:R> | <t:1767225600:R> | Developer docs |
Rules from Discord’s help articles, checked 5 Nov 2026; results are drawn by our preview, which is close to Discord but not identical.
Symbols combine: __***text***__ is underlined bold italics, and a spoiler can hold bold words. What’s missing matters too: there are no tables, no HTML and only three header sizes, so #### text stays as typed. Mentions, custom emoji and <t:…> dates appear as text in our preview while Discord fills them in; make time codes with the Discord timestamp generator.
Discord color text with ANSI code blocks
Discord has no colour button, but a code block marked ansi reads terminal colour codes. Each coloured piece starts with an invisible escape character (ESC) and a code such as [1;33m for bold yellow, and ends with [0m to reset. You get 8 text colours, 8 backgrounds, bold and underline.
Most keyboards can’t type ESC, so open Colour text, type your words, pick the colours and tap Add to message. The tool writes the codes and keeps the ESC characters when you copy; retyping them by hand won’t work. Colours show in Discord on desktop and the web, while phone apps may show plain text, and the preview here is an approximation of Discord’s palette.
Headers, subtext and lists
Start a line with # , ## or ### for three header sizes, or with -# for subtext: small grey text for footnotes and credits. The space after the symbol is required, and the symbol has to be at the very start of the line. For lists, begin lines with - or * for bullets and 1. for numbers; put two spaces before the dash to indent an item. The header and list buttons work on every selected line and renumber numbered lists. For tiny letters in places without markdown, use small text.
Spoilers, quotes and code blocks
Wrap words in ||double bars|| to cover them until a reader taps, or start a message with /spoiler. Spoilers don’t work inside code. A > quotes one line, while >>> quotes everything after it to the end of the message. One backtick on each side makes inline code; three backticks on lines of their own make a code block, which keeps every space, so ASCII art belongs in one. Add a language name after the opening backticks, such as js or py, and Discord may colour the code by language.
Show asterisks and underscores literally
Discord reads *, _, ~, |, backticks and \ as formatting, so ¯\_(ツ)_/¯ loses an arm and *important* turns italic. A backslash in front of a symbol keeps it as typed: \*important\*. Show my text literally adds backslashes to your selection, or to the whole message when nothing is selected; tap Undo to remove them. Names such as your display name don’t read markdown, so symbols show as typed there; style a name with Discord fonts instead.
Why formatting looks different on phones
Discord’s apps for Windows, Mac, the web, iPhone and Android don’t all draw formatting the same way. Colour text and coloured code are the usual differences, and older app versions can miss newer features like subtext. The preview here is close to Discord, not identical, so send a test in a private channel before an important post. For apps with no markdown at all, Unicode strikethrough text and underline text carry the effect in the letters themselves.
Questions
What is Discord markdown — does Discord use it?
Yes. Discord formats messages with markdown symbols: asterisks for bold and italics, tildes for strikethrough, # for headers and backticks for code. Its developer docs call it a subset of markdown, so some things you know from other sites, like tables, aren't there.
How do I use markdown in Discord?
Put symbols around words, like **bold** or ||spoiler||, or at the start of a line, like # for a header or > for a quote. Discord formats the message when you send it. The editor above adds the symbols for you and shows a preview first.
How do I stop Discord markdown from formatting my text?
Put a backslash before the symbol, so \* shows a plain asterisk, or wrap the text in backticks as code. Show my text literally adds the backslashes for you. Discord's markdown guide describes no setting that turns formatting off, so escaping is the reliable way.
Does Discord markdown support tables?
Tables aren't part of Discord's markdown guide, so pipes and dashes show up as typed. For a simple table, line up the columns with spaces inside a code block: code blocks use a monospaced font, so the columns stay straight on every screen.
Does Discord markdown support HTML?
No. HTML tags such as <b> or <br> show as plain text in Discord, and the preview here shows them the same way. Use the markdown symbols instead: **bold** for bold, a new line for a line break and # for big text.
Does Discord support markdown links?
Yes, as masked links: [text](https://example.com) shows the word text as a link to that address. Include the full address with https://. The Masked link button wraps your selection and selects https:// so you can paste the address straight in.
How do I strikethrough in Discord markdown?
Put two tildes on each side: ~~like this~~. Select words and tap Strikethrough to add them for you. For places that don't read markdown, such as display names, use Unicode strikethrough text instead.
How do I send a text file in Discord using markdown?
You don't need markdown for that. When a message goes over 2,000 characters (4,000 with Nitro), Discord turns it into a text file attachment. Formatting is made for normal messages, so keep the parts that need bold, headers or colour short enough to send as text.
Updated