ブログに戻る
Guide

Slackのマークダウンファイルのプレビュー:.mdファイルはどう表示されるか

Slackはアップロードした.mdファイルを書式付きで表示するようになりました。2026年10月28日のテストでは、ファイルビューアーで見出し、太字、チェックボックス、表が描画されました。MermaidのブロックとHTMLのタグは今も文字のままです。スクリーンショット、APIの出力、キャンバスのほうが向いている場面も紹介します。

Slack Green Team
October 29, 2026
October 29, 2026
5 分で読める
Share:
slack
markdown
canvas
developers

Slackは、マークダウンのファイルを書式付きで表示するようになりました。2026年10月28日のテストでは、SlackのWebアプリでチャンネルにアップロードした .md ファイルが、メッセージの中で書式付きのプレビューになりました。クリックすると全体表示が開き、見出し、太字、タスクリストのチェックボックス、表がそのまま描画されました。つまり、READMEをSlackで読むなら、先にキャンバスに貼り付けなくても、ファイルをアップロードするだけで済みます。今も描画されないものは2つあります。Mermaidのコードブロックはコードのまま表示され、HTMLのタグは文字のまま表示されます。ボットのメッセージなら、Block Kitの markdownブロック が12,000字までの標準的なマークダウンを書式にします。

ふつうのメッセージに入れるマークダウンの断片なら、無料のMarkdown to Slack変換ツール(英語)がSlack独自の書き方に直します。

2026年10月28日、Slackのチャンネルに置いたlaunch-checklist.mdファイル。メッセージのプレビューに見出し、太字のOwnerの行、箇条書きが出ている(英語表示)

テストのファイルがどう表示されたか

自分たちのフリープランのワークスペースのテスト用チャンネルに、Slackの files.getUploadURLExternal と files.completeUploadExternal のAPIで小さなマークダウンファイルを2つアップロードし、macOSのChromeで開いたSlackのWebアプリで見ました。

# Launch checklist

**Owner:** Sam
- [ ] Update the docs
- [x] Ship the release notes

| Step | Status |
| --- | --- |
| Build | done |
同じファイルをSlackのファイルビューアーで開いたところ。Launch checklistの見出し、太字のOwner: Sam、2つ目にチェックが入った2つのチェックボックス、2列の表(英語表示)
マークダウンメッセージの中のプレビュークリックしたあとの全体表示
# 見出し太字の行下に線が付いた大きな見出し
**太字**太字太字
- [ ] と - [x]角かっこが文字のまま残った箇条書きチェックボックス。[x] のほうにチェック
パイプの表途中で切れる。プレビューは最初の数行だけ見出し行が灰色の表
[text](url)リンクリンク
Mermaidのコードブロックコードブロックコードブロックのままで、図にならない
<b>HTML</b>タグが文字のままタグが文字のまま

SlackのAPIは、今もこのファイルをプレーンテキストとして扱っています。1つ目のファイルについて、files.info は次のように返しました。

{"name": "launch-checklist.md", "filetype": "markdown", "pretty_type": "Markdown (raw)", "mimetype": "text/plain", "mode": "snippet"}

つまり書式が付くのはSlackのビューアーの中だけです。ファイルそのものは変わらず、ダウンロードした人には同じ .md のテキストが届きます。デスクトップアプリとスマホのアプリでは試していません。

Slackでマークダウンが描画される場所

場所マークダウンは描画される?補足
アップロードした.mdファイルはい。プレビューとビューアーでMermaidとHTMLは文字のまま
メッセージの入力欄はい。貼り付けたとき手で打った [text](url) はCmd+Shift+Fが必要
キャンバスはい編集できる。見出し、リスト、300セルまでの表、チェックリスト
アプリから送るmarkdownブロックはい1メッセージで12,000字
APIの text フィールドいいえSlack独自のmrkdwnを使う

ファイルは読むためのものです。みんなで文書を編集するなら、キャンバスに置きましょう。

APIでマークダウンのファイルからキャンバスを作る

SlackのキャンバスのAPIは、マークダウンをそのまま受け取ります。canvases.create は "type": "markdown" の document_content オブジェクトを受け付け、テキストは1 MiBまでです。使える要素は、h1からh3の見出し、太字、斜体、取り消し線、箇条書きと番号付きリスト、チェックリスト、コードブロック、引用、区切り線、リンク、表、@メンションなどです。

# 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"])

キャンバスの表は300セルまでです。キャンバスの中ではBlock Kitは使えず、メンションの書き方も違います。うまくいった書き方はキャンバスAPIのテスト(英語)にあります。単独のキャンバスではなくチャンネルにキャンバスを付けるなら、チャンネルIDを指定して conversations.canvases.create を使います。

Slackで「離席中」と表示されなくなります

クラウドベース。ダウンロード不要。ノートPCがオフでも24時間稼働。

ボットのメッセージでマークダウンを送る

変更履歴やAIの回答のような短めの文なら、markdownブロックに入れて送ると、Slackが書式にします。

{
  "channel": "C0123456789",
  "blocks": [
    { "type": "markdown", "text": "## Release 3.4\n- Faster search\n- **Fixed:** login loop" }
  ]
}

上限は、1つのメッセージの中のmarkdownブロックすべてで12,000字です。このブロックとSlackの古いmrkdwnとの書き方の違いはSlackのBlock Kitのマークダウン(英語)にあります。

SlackでHTMLやMermaidは描画できる?

できません。2つ目のテストファイルでは、mermaid のコードブロックは図の元のコードが入った灰色のコードブロックとして表示されました。<b>HTML tag</b> もタグが文字のまま表示され、同じ行のマークダウンのリンクだけが働きました。

release-flow.mdを開いたSlackのファイルビューアー。Mermaidのグラフはコードのままで、HTMLのbタグも文字として表示され、横のリンクは使える(英語表示)

  • • HTML: 社内サイトやGitHub Pagesなどにページを公開して、リンクを共有します。Slackはリンクのプレビューを表示します。
  • • Mermaid: Mermaid Live Editorやドキュメントのツールから図をPNGかSVGで書き出し、画像をアップロードします。PNGなら会話の中にそのまま表示されます。

ふつうのメッセージにマークダウンを貼り付ける

貼り付けも使えるようになりました。10月27日のテストでは、メッセージ欄に貼り付けた標準的なマークダウンが、貼り付けた時点で書式になりました。太字、リンク、見出し、リスト、コードブロック、さらにパイプの表も本物の表になりました。手で打った [text](url) は、Cmd+Shift+F(Ctrl+Shift+F)を押して初めてリンクになります。アプリやボットのメッセージは、今も text フィールドで <url|text> が必要です。結果の全体はSlackでマークダウンが効かないときに、AIツールの文章についてはChatGPTの文章をSlackに貼り付ける方法(英語)にあります。

よくある質問

Slackでマークダウンのファイルをプレビューできますか? できます。2026年10月28日のテストでは、Webアプリがアップロードした .md ファイルを書式付きで表示し、全体表示では見出し、チェックボックス、表も描画しました。

SlackでMermaidの図は描画できますか? できません。.md ファイルの中のMermaidのブロックはコードのまま表示されます。図を画像として書き出してアップロードしてください。

SlackでHTMLは描画できますか? できません。HTMLのタグは文字のまま表示されます。公開したページのリンクか、スクリーンショットを共有してください。

Slackのキャンバスはマークダウンに対応していますか? はい。キャンバスは見出し、リスト、表、チェックリスト、コードに対応していて、キャンバスのAPIはマークダウンをそのまま受け取ります。

Always Active

マウスを動かす必要はもうありません。

何百人ものリモートワーカーがSlackのステータスを気にしなくなりました。一度設定すれば、永遠にグリーン。

関連記事

Guide

Slackでマークダウンが効かない?入力、貼り付け、投稿で書式になるもの

Slackに貼り付けた標準のマークダウンは、今は表も含めて貼り付けた時点で書式になります。入力したチルダ2つの取り消し線とリンクの記法はならず、マークアップモードはアスタリスクを残し、ボットにはmrkdwnが必要です。10月27日のテスト結果です。

Slack Green Team
Guide

Slackのメッセージが灰色になるのはなぜ?(検証済み)

Slackのメッセージが灰色なのは、まだSlackに届いていないからです。接続を切って灰色の文字を測り、問題のない灰色の行も確かめました。

Slack Green Team
Guide

Slackで表示名を変える方法(検証済み)

Slackの表示名はプロフィールの編集で変えられます。どこに表示されるか、Slackがどんな名前を断るか、変更が反映されないのはなぜかを試しました。

Slack Green Team