Slack Markdown File Preview: What a .md File Shows in Slack
Slack now renders an uploaded .md file: our 28 October 2026 test showed headings, bold text, checkboxes and a table in the file viewer. Mermaid blocks and HTML tags still show as text. Screenshots, the API output, and when a canvas is still the better choice.
On this page
Slack now shows a markdown file formatted. In our test on 28 October 2026, a .md file uploaded to a channel in the Slack web app showed a formatted preview in the message, and clicking it opened a full view with the heading, bold text, task-list checkboxes and a table rendered. So to read a README in Slack you can simply upload it; you no longer have to paste it into a canvas first. Two things still do not render: a Mermaid code block shows as code, and raw HTML tags show as text. For a bot message, the Block Kit markdown block formats standard markdown up to 12,000 characters.
For a markdown snippet going into a normal message, our free Markdown to Slack converter rewrites it in Slack's own syntax.
What our test file showed
We uploaded two small markdown files to a test channel of our own Free workspace with Slack's files.getUploadURLExternal and files.completeUploadExternal API calls, then looked at them in the Slack web app in Chrome on macOS.
# Launch checklist
**Owner:** Sam
- [ ] Update the docs
- [x] Ship the release notes
| Step | Status |
| --- | --- |
| Build | done |
| Markdown | Preview in the message | Full view after a click |
|---|---|---|
# Heading | Bold line | Large heading with a rule under it |
**bold** | Bold | Bold |
- [ ] and - [x] | Bullets with the brackets as text | Checkboxes, the [x] one ticked |
| Pipe table | Cut off, the preview shows the first lines | Table with a grey header row |
[text](url) | Link | Link |
| Mermaid fence | Code block | Code block, no diagram |
<b>HTML</b> | Tags as text | Tags as text |
Slack's API still describes the file as plain text. files.info returned this for the first upload:
{"name": "launch-checklist.md", "filetype": "markdown", "pretty_type": "Markdown (raw)", "mimetype": "text/plain", "mode": "snippet"}
So the formatting happens only in Slack's viewer. The file itself is unchanged, and anyone who downloads it gets the same .md text. We did not repeat the test in the desktop or mobile apps.
Where markdown renders in Slack
| Where | Renders markdown? | Notes |
|---|---|---|
| Uploaded .md file | Yes, in the preview and viewer | Mermaid and HTML stay as text |
| Message composer | Yes, when pasted | Typed [text](url) needs Cmd+Shift+F |
| Canvas | Yes | Editable; headings, lists, tables up to 300 cells, checklists |
| Markdown block, from an app | Yes | 12,000 characters per message |
API text field | No | Uses Slack's own mrkdwn |
A file is for reading. If people should edit the document together, put it in a canvas instead.
Create a canvas from a markdown file with the API
Slack's canvas API takes markdown directly. canvases.create accepts a document_content object with "type": "markdown", up to 1 MiB of text. The supported elements include headings h1 to h3, bold, italic, strikethrough, bulleted and ordered lists, checklists, code blocks, quotes, dividers, links, tables and @mentions.
# pip install slack_sdk ; needs a bot token with the canvases:write scope
from pathlib import Path
from slack_sdk import WebClient
client = WebClient(token="xoxb-your-bot-token")
text = Path("README.md").read_text()
resp = client.canvases_create(
title="README",
document_content={"type": "markdown", "markdown": text},
)
print(resp["canvas_id"])
Canvas tables are limited to 300 cells. Block Kit does not work inside canvases, and mentions use a different syntax there; our canvas API test shows the form that works. To attach the canvas to a channel instead of creating a standalone one, use conversations.canvases.create with the channel ID.
Never appear "away" on Slack again
Cloud-based. No downloads. Works 24/7 even when your laptop is off.
Send markdown as a bot message
For shorter text, such as a changelog or an AI answer, send it in a markdown block and Slack formats it:
{
"channel": "C0123456789",
"blocks": [
{ "type": "markdown", "text": "## Release 3.4\n- Faster search\n- **Fixed:** login loop" }
]
}
The limit is 12,000 characters for all markdown blocks in one message. The syntax differences between this block and Slack's older mrkdwn are in Slack Block Kit markdown.
Can Slack render HTML or Mermaid?
No. In our second test file, a mermaid code block showed as a grey code block with the diagram source, and <b>HTML tag</b> showed with the tags as text, while the markdown link in the same line worked.
- • HTML: publish the page somewhere (an internal site, GitHub Pages) and share the link. Slack shows a link preview.
- • Mermaid: export the diagram as PNG or SVG from the Mermaid Live Editor or your docs tool, and upload the image. A PNG shows inline in the conversation.
Paste markdown into a normal message
Pasting works now too. In our 27 October test, standard markdown pasted into the message box formatted on paste: bold, links, headings, lists, code fences and even a pipe table, which became a real table. A typed [text](url) becomes a link only after Cmd+Shift+F (Ctrl+Shift+F). App and bot messages still need <url|text> in the text field. The full results are in Slack markdown not working, and how to paste ChatGPT into Slack covers text from AI tools.
FAQ
Can Slack preview markdown files?
Yes. In our 28 October 2026 test the web app showed an uploaded .md file formatted, with headings, checkboxes and tables in the full view.
Can Slack render Mermaid diagrams?
No. A Mermaid block in a .md file shows as code. Export the diagram as an image and upload it.
Can Slack render HTML? No. HTML tags show as text. Share a link to the hosted page, or a screenshot.
Does a Slack canvas support markdown? Yes. Canvases support headings, lists, tables, checklists and code, and the canvas API takes markdown directly.
Stop Jiggling Your Mouse.
Join hundreds of remote workers who never worry about their Slack status. Set it up once, stay green forever.
Related Articles
Convert a Slack Message to Markdown (Tested Python Code)
Read the rich_text blocks, not the text field. We pasted a Markdown note into Slack on 18 November 2026, read it back with the API, and a 29-line Python function rebuilt the exact Markdown we pasted.
Argo CD Slack Notifications: Setup and Fixes (Tested)
Argo CD posts sync results to Slack through its notifications controller. We set it up on v3.6.2 and show the messages and three errors we hit.
Slack App Configuration Token: Generate, Rotate and Revoke
An app configuration token lets a script create Slack apps from manifests. We generated one, rotated it five times and tested it again 28 hours later.