Back to Details

slack-messaging

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Slack Messaging Best Practices

Slack消息撰写最佳实践

This skill provides guidance for composing well-formatted, effective Slack messages.
本技能为撰写格式规范、高效的Slack消息提供指导。

When to Use

适用场景

Apply this skill whenever composing, drafting, or helping the user write a Slack message — including when using 
slack_send_message
, 
slack_send_message_draft
, or 
slack_create_canvas
.
在撰写、草拟或协助用户编写Slack消息时均可应用本技能——包括使用
slack_send_message
、
slack_send_message_draft
或
slack_create_canvas
工具时。

Slack Formatting (mrkdwn)

Slack格式（mrkdwn）

Slack uses its own markup syntax called mrkdwn, which differs from standard Markdown. Always use mrkdwn when composing Slack messages:
FormatSyntaxNotes
Bold
*text*
Single asterisks, NOT double
Italic
_text_
Underscores
Strikethrough
~text~
Tildes
Code (inline)
`code`
Backticks
Code block
```code```
Triple backticks
Quote
> text
Angle bracket
Link
<url|display text>
Pipe-separated in angle brackets
User mention
<@U123456>
User ID in angle brackets
Channel mention
<#C123456>
Channel ID in angle brackets
Bulleted list
- item
or 
• item
Dash or bullet character
Numbered list
1. item
Number followed by period
Slack使用自有标记语法mrkdwn，与标准Markdown不同。撰写Slack消息时请始终使用mrkdwn：
格式语法说明
粗体
*text*
单个星号，而非双个
斜体
_text_
下划线
删除线
~text~
波浪线
行内代码
`code`
反引号
代码块
```code```
三个反引号
引用
> text
尖括号
链接
<url|display text>
尖括号内用竖线分隔
提及用户
<@U123456>
尖括号内包含用户ID
提及频道
<#C123456>
尖括号内包含频道ID
无序列表
- item
或 
• item
短横线或项目符号
有序列表
1. item
数字加句号

Common Mistakes to Avoid

需避免的常见错误

  • Do NOT use 
    **bold**
    (double asterisks) — Slack uses 
    *bold*
    (single asterisks)
  • Do NOT use 
    ## headers
    — Slack does not support Markdown headers. Use 
    *bold text*
    on its own line instead.
  • Do NOT use 
    [text](url)
    for links — Slack uses 
    <url|text>
    format
  • Do NOT use 
    ---
    for horizontal rules — Slack does not render these
  • 请勿使用
    **bold**
    （双星号）——Slack使用
    *bold*
    （单星号）
  • 请勿使用
    ## headers
    ——Slack不支持Markdown标题。请单独一行使用
    *粗体文本*
    替代。
  • 请勿使用
    [text](url)
    格式添加链接——Slack使用
    <url|text>
    格式
  • 请勿使用
    ---
    作为水平分隔线——Slack不会渲染该格式

Message Structure Guidelines

消息结构指南

  • Lead with the point. Put the most important information in the first line. Many people read Slack on mobile or in notifications where only the first line shows.
  • Keep it short. Aim for 1-3 short paragraphs. If the message is long, consider using a Canvas instead.
  • Use line breaks generously. Walls of text are hard to read. Separate distinct thoughts with blank lines.
  • Use bullet points for lists. Anything with 3+ items should be a list, not a run-on sentence.
  • Bold key information. Use 
    *bold*
    for names, dates, deadlines, and action items so they stand out when scanning.
  • 开门见山。将最重要的信息放在第一行。很多人在移动端或通知中查看Slack，通常只会显示第一行内容。
  • 保持简洁。目标是1-3个简短段落。如果消息过长，考虑使用Canvas替代。
  • 合理使用换行。大段文字难以阅读。用空白行分隔不同的想法。
  • 列表使用项目符号。任何包含3个及以上条目的内容应使用列表，而非冗长的句子。
  • 关键信息加粗。对名称、日期、截止日期和行动项使用
    *粗体*
    ，以便在快速浏览时突出显示。

Thread vs. Channel Etiquette

线程与频道礼仪

  • Reply in threads when responding to a specific message to keep the main channel clean.
  • Use 
    reply_broadcast
     (also post to channel) only when the reply contains information everyone needs to see.
  • Post in the channel (not a thread) when starting a new topic, making an announcement, or asking a question to the whole group.
  • Don't start a new thread to continue an existing conversation — find and reply to the original message.
  • 回复至线程。在回复特定消息时使用线程，保持主频道整洁。
  • 仅在必要时使用
    reply_broadcast
    （同时发布至频道）。只有当回复内容是所有人都需要查看的信息时才使用该功能。
  • 发布至频道（而非线程）。当开启新话题、发布公告或向全体成员提问时，直接发布至频道。
  • 不要开启新线程延续现有对话。找到原始消息并回复。

Tone and Audience

语气与受众

  • Match the tone to the channel — 
    #general
    is usually more formal than 
    #random
    .
  • Use emoji reactions instead of reply messages for simple acknowledgments (though note: the MCP tools can't add reactions, so suggest the user do this manually if appropriate).
  • When writing announcements, use a clear structure: context, key info, call to action.
  • 匹配频道语气——
    #general
    频道通常比
    #random
    更正式。
  • 对于简单确认，使用表情反应而非回复消息（注意：MCP工具无法添加反应，因此如果合适，建议用户手动操作）。
  • 撰写公告时，使用清晰的结构：背景、关键信息、行动号召。