Slack Message Formatting Syntax (mrkdwn vs Markdown)
Slack uses mrkdwn, not standard Markdown: one asterisk for bold, underscores for italic, and angle-bracket links. Here is the full reference.
Direct answer
Slack uses its own mrkdwn syntax, not standard Markdown: *bold* with a single asterisk, _italic_ with underscores, ~strike~ with a single tilde, `code` and ```code blocks```, and <https://url|link text> for links. Standard Markdown like **bold** and [text](url) does not render in mrkdwn, so convert first.
Open Markdown to Slack converterWhen to use this
- You are writing a Slack message, bot message, or Slack app payload.
- Your Markdown formatting shows literal asterisks or brackets in Slack.
- You need the exact mrkdwn syntax for bold, italic, links, and code.
Steps
- Use a single asterisk for bold: *important*.
- Use underscores for italic: _emphasis_.
- Use a single tilde for strikethrough: ~old~.
- Use backticks for `inline code` and triple backticks for a code block.
- Write links as <https://example.com|link text>, not [link text](url).
- Convert standard Markdown to mrkdwn before pasting into a message or app payload.
Example conversion
# Deploy notes **Shipped** the new editor and *fixed* the ~~broken~~ export. See the [runbook](https://example.com/runbook) and run `npm run deploy`.
*Deploy notes* *Shipped* the new editor and _fixed_ the ~broken~ export. See the <https://example.com/runbook|runbook> and run `npm run deploy`.
Common mistakes
- Slack bold is one asterisk (*bold*), not two — **bold** shows literal asterisks in mrkdwn.
- Slack has no heading syntax in mrkdwn; a Markdown heading becomes bold text.
- Slack links are <url|text> with angle brackets, not Markdown [text](url).
FAQ
- Does Slack use Markdown?
- Not exactly. Slack uses mrkdwn, its own variant. Bold is a single asterisk, italic uses underscores, strikethrough is a single tilde, and links use <url|text>. Standard Markdown syntax does not render the same way.
- Why does my Markdown show asterisks in Slack?
- You likely used **bold** (standard Markdown). In mrkdwn, bold is a single asterisk, so the extra asterisks appear as literal text. Convert to mrkdwn first.
- How do I write a link in a Slack message?
- Use angle-bracket syntax: <https://example.com|link text>. Markdown-style [link text](url) is not valid mrkdwn and will show as plain text.
Related Markdown guides
Related Markdown to Slack guides
Convert Markdown to Slack mrkdwn
Turn standard Markdown into Slack mrkdwn — bold, italic, strikethrough, links, and headings mapped to Slack's syntax.
How to Post Code Blocks in Slack
Use backticks for inline code and triple backticks for multi-line code blocks in Slack messages, and know what Slack does not support.
Slack Bold and Italic Not Working? Use mrkdwn
If **bold** or __italic__ shows literal symbols in Slack, you are using Markdown instead of mrkdwn. Here is the fix.
Paste Formatted Text Into Slack Without Breaking It
Move text from Markdown, Google Docs, or Notion into Slack cleanly by converting to mrkdwn or clearing carried-over formatting.
How to Make Bullet Points and Lists in Slack
Create bullet points and numbered lists in Slack using the composer's list buttons or literal bullet characters for bot messages.
Desk gear for long writing sessions
A few things that help if you write docs, tickets, and specs on a laptop all day.
Anker 5-in-1 USB-C Hub
One cable turns a laptop into a desk setup. Drives a 4K display, charges at up to 85W, and adds three data ports.
- 4K HDMI output
- 85W max power delivery
- 1x USB-C + 2x USB-A, 5Gbps each
- MacBook Pro, MacBook Air, Dell
Dell 27" S2725QC 4K
The monitor I write and review documents on. 163 PPI keeps small text sharp, and USB-C carries video and power on one cable.
- 3840x2160 IPS, 163 PPI
- 120Hz, 4ms, FreeSync Premium
- 99% sRGB
- USB-C, HDMI, DisplayPort
Apple MacBook Neo 13" (A18 Pro)
The cheapest way into an Apple-silicon machine that runs local models. Fanless, and the Liquid Retina panel holds small text at a full day of reading.
- A18 Pro chip, built for Apple Intelligence
- 8GB unified memory, 256GB SSD
- 13-inch Liquid Retina display
- 1080p FaceTime HD camera
Amazon affiliate links. We earn a commission on qualifying purchases at no extra cost to you.