Back to Blog
Guide

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.

Slack Green Team
September 28, 2026
October 28, 2026
4 min read
Share:
slack
markdown
canvas
developers

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.

A launch-checklist.md file in a Slack channel on 28 October 2026: the message preview shows the heading, bold Owner line and a bulleted list

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 |
The same file opened in Slack's file viewer: a Launch checklist heading, Owner: Sam in bold, two checkboxes with the second one ticked, and a two-column table
MarkdownPreview in the messageFull view after a click
# HeadingBold lineLarge heading with a rule under it
**bold**BoldBold
- [ ] and - [x]Bullets with the brackets as textCheckboxes, the [x] one ticked
Pipe tableCut off, the preview shows the first linesTable with a grey header row
[text](url)LinkLink
Mermaid fenceCode blockCode block, no diagram
<b>HTML</b>Tags as textTags 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

WhereRenders markdown?Notes
Uploaded .md fileYes, in the preview and viewerMermaid and HTML stay as text
Message composerYes, when pastedTyped [text](url) needs Cmd+Shift+F
CanvasYesEditable; headings, lists, tables up to 300 cells, checklists
Markdown block, from an appYes12,000 characters per message
API text fieldNoUses 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.

Slack's file viewer for release-flow.md: the Mermaid graph shows as code, and the HTML b tags show as literal text next to a working link

  • • 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.

Always Active

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

Developers

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.

Slack Green Team
Developers

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 Green Team
Developers

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.

Slack Green Team