关于 slack-message-formatter
将 Markdown 转换为适用于 Slack 的消息,支持富文本粘贴、mrkdwn 投递和 Slack 风格的浏览器预览,适合撰写公告、通知及通过 Webhook 发送消息。
主要功能
- 01Markdown 转为富文本 HTML
- 02生成 API 和 Webhook 用 mrkdwn
- 03Slack 风格的浏览器预览
- 04自动复制到剪贴板
- 05支持列表、表格、代码和提及
适用场景
- 01准备格式完整的 Slack 公告
- 02发布前预览消息效果
- 03通过 Webhook 发送部署通知
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davepoon/ buildwithclaude --skill slack-message-formatter安装后在 Claude Code 中输入/slack-message-formatter确认已加载。
详细介绍
Slack 消息格式化工具
以像素级精度格式化 Slack 消息。将 Markdown 转换为兼容 Slack 的输出,支持两种发送方式:
- 复制粘贴 — 生成富 HTML,粘贴到 Slack 的编辑框时保留格式
- API/Webhook — 使用 Slack mrkdwn 语法,适用于机器人、自动化和 CI/CD
何时使用此工具
- 用户要求撰写 Slack 消息、公告或通知
- 用户要求将内容“格式化为适用于 Slack 的样式”
- 用户希望预览消息在 Slack 中的显示效果
- 用户希望通过 Slack webhook 发送消息
- 用户有想要分享到 Slack 的 Markdown 内容
此工具的功能
- 以 Markdown 生成内容 — Claude 使用其原生格式标准 Markdown 撰写消息
- 转换为富 HTML — 将 Markdown 转换为富 HTML,粘贴到 Slack 的编辑框时保留格式
- 转换为 Slack mrkdwn — 将 Markdown 转换为 Slack 专有的 mrkdwn 语法,以便通过 API/webhook 发送
- 生成 Slack 主题预览 — 创建一个采用 Slack UI 样式的 HTML 预览页面,并在浏览器中打开
- 复制到剪贴板 — 自动将富 HTML 复制到系统剪贴板,只需一步即可粘贴到 Slack
使用方法
基本用法
Write a Slack message announcing our Q2 product launch
Format this for Slack: We shipped 3 new features this week...
Create a Slack announcement for the engineering team about the new CI pipeline
Webhook/API 发送
Send a deploy notification to Slack via webhook
格式功能
转换器会处理所有 Markdown 功能,并将其正确转换为 Slack 格式:
- 粗体、斜体、删除线、行内代码
- 链接和标题(在 Slack 中转换为粗体)
- 表格(粘贴时使用富 HTML 表格,通过 API 发送时使用代码块)
- 带有表情符号复选框的任务列表
- 嵌套列表和引用块
- 带语法高亮的代码块
- Slack 提及(
<@U012AB3CD>、<!here>、<!channel>) - 将 150 多种表情符号短代码转换为 Unicode
示例
用户:“撰写一条 Slack 消息,宣布我们的新功能”
输出(在浏览器中打开 Slack 主题预览,并复制到剪贴板):
预览会以像素级精度呈现 Slack UI。用户使用 Cmd+V / Ctrl+V 直接粘贴到 Slack,格式会得到保留。
用户:“通过 webhook 向我们的 #deploys 频道发送部署通知”
输出(通过 mrkdwn 发送到已配置的 webhook):
*:rocket: Deploy Successful*
*Service:* payment-api
*Version:* v2.5.1
*Environment:* production
*Duration:* 47s
:white_check_mark: All health checks passing
配置
| 环境变量 | 默认值 | 说明 |
|---|---|---|
SLACK_FORMATTER_CLIPBOARD | true | 设为 false 可禁用自动复制到剪贴板 |
SLACK_FORMATTER_PREVIEW_DIR | /tmp/slack-formatter | 预览 HTML 文件的目录 |
CCH_SLA_WEBHOOK | (none) | 用于发送消息的 Slack webhook URL |
提示
- 始终让转换器处理 Markdown 到 Slack 格式的转换;不要手动编写 mrkdwn 或 HTML
- 可以直接在 Markdown 中加入 Slack 提及(
<@U...>、<#C...>、<!here>) - 通过复制粘贴方式处理表格效果很好;通过 API 发送时会转换为代码块(Slack 没有表格语法)
- 预览文件会带有时间戳,方便你从对话历史中再次查看
评论
支持 Markdown