Slack 마크다운 파일 미리 보기: .md 파일은 어떻게 보일까
이제 Slack은 올린 .md 파일을 서식이 적용된 모습으로 보여 줍니다. 2026년 10월 28일 테스트에서 파일 뷰어는 제목, 굵은 글씨, 체크 상자, 표를 그렸습니다. Mermaid 블록과 HTML 태그는 여전히 글자로 보입니다. 스크린숏, API 출력, 캔버스가 더 나은 경우까지 정리했습니다.
On this page
이제 Slack은 마크다운 파일을 서식이 적용된 모습으로 보여 줍니다. 2026년 10월 28일 테스트에서 Slack 웹 앱으로 채널에 올린 .md 파일은 메시지 안에서 서식이 적용된 미리 보기로 나왔고, 클릭하면 전체 보기가 열리며 제목, 굵은 글씨, 할 일 목록 체크 상자, 표가 모두 그려졌습니다. 그러니 README를 Slack에서 읽으려면 먼저 캔버스에 붙여 넣을 필요 없이 파일을 올리기만 하면 됩니다. 아직 그려지지 않는 것은 두 가지입니다. Mermaid 코드 블록은 코드로 보이고, HTML 태그는 글자 그대로 보입니다. 봇 메시지라면 Block Kit의 markdown 블록 이 12,000자까지의 표준 마크다운을 서식으로 바꿔 줍니다.
일반 메시지에 넣을 마크다운 조각이라면 무료 Markdown to Slack 변환 도구(영어)가 Slack 고유 문법으로 바꿔 줍니다.
테스트 파일이 어떻게 보였나
저희 무료 워크스페이스의 테스트 채널에 Slack의 files.getUploadURLExternal과 files.completeUploadExternal API로 작은 마크다운 파일 두 개를 올리고, macOS의 Chrome에서 연 Slack 웹 앱으로 확인했습니다.
# Launch checklist
**Owner:** Sam
- [ ] Update the docs
- [x] Ship the release notes
| Step | Status |
| --- | --- |
| Build | done |
| 마크다운 | 메시지 안의 미리 보기 | 클릭한 뒤의 전체 보기 |
|---|---|---|
# 제목 | 굵은 줄 | 아래에 선이 있는 큰 제목 |
**굵게** | 굵게 | 굵게 |
- [ ]와 - [x] | 대괄호가 글자로 남은 글머리 기호 | 체크 상자, [x] 쪽은 체크됨 |
| 파이프 표 | 잘림, 미리 보기는 앞의 몇 줄만 | 머리글 행이 회색인 표 |
[text](url) | 링크 | 링크 |
| Mermaid 코드 블록 | 코드 블록 | 코드 블록, 다이어그램 없음 |
<b>HTML</b> | 태그가 글자로 | 태그가 글자로 |
Slack API는 여전히 이 파일을 일반 텍스트로 설명합니다. 첫 번째 파일에 대해 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 블록 | 예 | 메시지당 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에서 다시는 '자리 비움'으로 표시되지 마세요
클라우드 기반. 다운로드 불필요. 노트북이 꺼져 있어도 24시간 작동.
봇 메시지로 마크다운 보내기
변경 기록이나 AI 답변처럼 짧은 글은 markdown 블록에 담아 보내면 Slack이 서식을 적용합니다.
{
"channel": "C0123456789",
"blocks": [
{ "type": "markdown", "text": "## Release 3.4\n- Faster search\n- **Fixed:** login loop" }
]
}
한도는 메시지 하나에 들어가는 markdown 블록 전체를 합쳐 12,000자입니다. 이 블록과 Slack의 예전 mrkdwn 사이의 문법 차이는 Slack Block Kit 마크다운(영어)에 있습니다.
Slack은 HTML이나 Mermaid를 그릴 수 있나?
없습니다. 두 번째 테스트 파일에서 mermaid 코드 블록은 다이어그램 원본이 든 회색 코드 블록으로 보였고, <b>HTML tag</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일 테스트에서 웹 앱은 올린 .md 파일을 서식이 적용된 모습으로 보여 줬고, 전체 보기에서는 제목, 체크 상자, 표까지 그렸습니다.
Slack에서 Mermaid 다이어그램을 그릴 수 있나요?
아니요. .md 파일 안의 Mermaid 블록은 코드로 보입니다. 다이어그램을 이미지로 내보내 올리세요.
Slack에서 HTML을 그릴 수 있나요? 아니요. HTML 태그는 글자로 보입니다. 올려 둔 페이지의 링크나 스크린숏을 공유하세요.
Slack 캔버스는 마크다운을 지원하나요? 네. 캔버스는 제목, 목록, 표, 체크리스트, 코드를 지원하고, 캔버스 API는 마크다운을 그대로 받습니다.
관련 기사
Slack 마크다운이 안 될 때: 입력, 붙여넣기, 봇에서 서식이 되는 것
Slack에 붙여 넣은 표준 마크다운은 이제 표까지 붙여 넣는 순간 서식이 됩니다. 직접 친 물결표 두 개 취소선과 링크 문법은 안 되고, 마크업 모드는 별표를 남기며, 봇에는 mrkdwn이 필요합니다. 10월 27일 테스트 결과입니다.
Slack 메시지가 회색인 이유는?(직접 시험)
Slack 메시지가 회색이라면 아직 Slack에 닿지 않은 것입니다. 연결을 끊고 회색 글자를 측정했고, 문제없는 회색 줄도 확인했습니다.
Slack 표시 이름 바꾸는 법(직접 시험)
Slack 표시 이름은 프로필 편집에서 바꿀 수 있습니다. 어디에 보이는지, Slack이 어떤 이름을 거절하는지, 바꾼 이름이 반영되지 않는 이유를 시험했습니다.