---slug: "whatsapp-styling-guide-free" name: "whatsapp-styling-guide-free" version: "1.0.0" displayName: "WhatsApp 排版入门" summary: "WhatsApp消息排" summary_zh: "WhatsApp消息排版基础指南,涵盖核心语法规则、禁用范式与基础通知模板。WhatsApp消息排版基础指南(免费版)。提供WhatsApp原生排版语法的核心规则说明、常见禁用范式与替代方案" license: "MIT" description: |- WhatsApp消息排版基础指南(免费版)。提供WhatsApp原生排版语法的核心规则说明、常见禁用范式与替代方案, 以及通知类基础消息模板。覆盖三大基础能力:核心语法参考(加粗/斜体/删除线/列表的写法与效果)、 基础禁用范式(井号标题/Markdown表格/双星号的替代方案)、基础通知模板(订单确认与物流更新). 适用于个人开发者编写WhatsApp通知消息、日常消息排版优化等基础场景. 如需完整模板库(客服/营销/公告)、风格规范、Markdown差异对照、内容类型排版建议等高级能力, 请升级至whatsapp-styling-guide付费版. tags:
- 需求设计
- UI设计
- 前端
- 设计
- markdown
- text
- agent
- 消息 tools:
- read
- write
- exec homepage: "" category: "Creative"---# WhatsApp 排版入门
WhatsApp消息排版的基础参考指南。涵盖核心语法规则、常见禁用范式与替代方案,以及通知类基础模板。帮助快速掌握WhatsApp原生排版,写出干净自然的消息.
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | WhatsApp 排版入门处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
依赖说明
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
- LLM能力: 需要Agent内置LLM提供文本理解与排版建议能力
依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供,无需额外配置 |
API Key 配置
- 本Skill基于指令驱动,无需额外API Key
可用性分类
- 分类: MD(纯Markdown指令,无需exec命令行执行能力)
- 说明: 基于Markdown的AI Skill,作为排版参考指南驱动Agent按规范输出WhatsApp消息
核心能力
1. 核心语法参考
WhatsApp支持的原生排版语法基础说明. 支持的语法:
- 加粗: 用单星号包裹
*text*,用于关键词强调、金额、日期等重要信息 - 斜体: 用单下划线包裹
_text_,用于补充说明、语气弱化 删除线: 用单波浪线包裹~text~,用于原价划除、已过期信息标注- 项目符号列表: 星号加空格
* Item,用于商品明细、操作步骤 - 编号列表: 数字加句点
1. Item,用于有顺序的步骤说明
关键差异: WhatsApp用单星号表示加粗(非双星号),单下划线表示斜体,单波浪线表示删除线。这与标准Markdown不同,直接发送Markdown会导致接收方看到原始符号.
2. 基础禁用范式
WhatsApp不支持的常见Markdown元素及其替代方案. 禁用范式与替代方案:
- 井号标题(
#/##): WhatsApp不渲染。替代: 用*加粗*作为标题 - Markdown表格(
| col |): WhatsApp不渲染。替代: 转为项目符号列表* 列1: 列2 - 双星号加粗(
**text**): 显示原始星号。替代: 用单星号*text* - 双波浪线(
~~text~~): 显示原始波浪线。替代: 用单波浪线~text~ - 水平分割线(
---): 可能被误判。替代: 用下划线行__________
3. 基础通知模板
面向通知场景的基础消息模板,可直接套用并替换变量内容. 订单确认模板:
*订单确认*
订单号: ORD20250118
商品: 蓝牙耳机 x1
金额: *¥299*
预计 _3-5个工作日_ 送达.
# ...
如有疑问请回复此消息.
物流更新模板:
*物流更新*
您的订单 ORD20250118 已发出.
# ...
* 当前位置: 深圳转运中心
* 预计送达: _1月20日_
# ...
> 回复1查看完整物流轨迹
快速开始
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
适用场景
| 场景 | 输入 | 输出 |
|---|---|---|
| 通知模板编写 | 业务通知需求(订单/物流) | 符合排版规范的WhatsApp通知模板 |
| 日常消息排版 | 需要格式化的WhatsApp消息 | WhatsApp原生格式消息 |
不适用于: 客服话术设计、营销消息排版、团队消息标准化(需升级付费版)
使用流程
- 明确消息类型: 确定要编写的消息属于通知还是日常沟通
- 选择对应模板: 从基础通知模板中选择最接近的作为起点
- 填充业务内容: 将模板中的变量替换为实际业务数据
- 校验禁用范式: 检查消息中是否使用了WhatsApp不支持的Markdown元素
- 输出最终消息: 输出符合排版规范的WhatsApp消息
示例
示例1: 订单确认通知模板设计
需求: 为电商设计订单确认的WhatsApp通知,包含订单号、商品、金额、预计送达时间
最终模板:
*订单确认*
订单号: ORD20250118
# ...
*商品明细*
* 蓝牙耳机: 1件 ¥299
* 手机壳: 2件 ¥78
# ...
*合计: ¥377*
预计 _3-5个工作日_ 送达.
# ...
如有疑问请回复此消息.
排版分析: 标题用加粗标明消息性质;商品明细用项目符号列表(清晰可扫读);金额用加粗(接收方一眼看到关键数据);预计时间用斜体(辅助信息弱化).
示例2: 日常消息格式优化
需求: 将一条含Markdown格式的日常消息转为WhatsApp格式
输入(含错误格式):
**系统维护通知**
~~原定23:00~~ 改为 22:00 开始
预计 *2小时* 完成
输出(WhatsApp格式):
*系统维护通知*
~原定23:00~ 改为 22:00 开始
预计 _2小时_ 完成
排版分析: **双星号**转为*单星号*;~~双波浪线~~转为~单波浪线~;Markdown斜体*2小时*转为WhatsApp斜体_2小时_.
异常处理
| 错误场景 | 错误信息/现象 | 原因分析 | 处理方式 |
|---|---|---|---|
| 加粗不生效 | 接收方看到*text*原始星号 | 星号与文字间有空格 | 确保*紧贴文字,写法为*text*而非* text * |
| 列表项不渲染 | 接收方看到*Item而非列表圆点 | 星号后缺少空格 | 写法为* Item(星号加空格加内容) |
| 双星号显示异常 | 接收方看到**text** | 消息残留Markdown双星号 | 将**text**替换为*text* |
| 井号标题显示异常 | 接收方看到# 标题 | WhatsApp不渲染标题语法 | 将# Header替换为*Header* |
| 表格显示混乱 | 接收方看到竖线混乱排列 | WhatsApp不支持表格 | 将表格转为项目符号列表 |
常见问题
Q1: WhatsApp加粗为什么用单星号而不是双星号?
A: WhatsApp的格式语法是平台自定义的,与标准Markdown不同。WhatsApp用*text*(单星号)表示加粗,_text_(单下划线)表示斜体,~text~(单波浪线)表示删除线。如果直接发送Markdown的**text**,接收方会看到原始双星号而非加粗效果。编写WhatsApp消息时需使用单星号语法.
Q2: 什么时候该用加粗,什么时候该用斜体?
A: 加粗用于接收方必须注意到的关键信息:金额、截止日期、订单号、重要提醒。斜体用于辅助或补充信息:预计时间、可选操作、语气修饰。判断标准:如果这条信息漏看会导致问题(如错过退款),用加粗;如果漏看不影响核心操作(如预计送达时间是估算),用斜体。避免全篇加粗,加粗过多等于没有加粗.
Q3: 如何在WhatsApp消息中展示结构化数据(如商品列表)?
A: WhatsApp不支持Markdown表格。替代方案:用项目符号列表,每行格式为* 列名: 值。例如商品明细写为* 蓝牙耳机: 1件 ¥299。如果有表头需求,在列表前加一行加粗标题,如*商品明细*后跟列表项。原则是用列表加加粗组合替代表格,保持信息可扫读.
Q4: 免费版和付费版有什么区别?
A: 免费版(入门)包含核心语法参考(加粗/斜体/删除线/列表)、基础禁用范式与2个通知模板。付费版(WhatsApp 排版指南)额外提供:
- 完整语法参考(含等宽字体、引用、多行引用等高级语法)
- 完整禁用范式目录(含嵌套格式、HTML标签等)
- Human-to-Human风格规范(语气、信息层次、视觉节奏)
- 四类即用模板库(订单通知/物流更新/客服回复/促销公告)
- Markdown差异对照表(7项差异详解)
- 内容类型排版建议(通知/列表/对话/营销四类)
- 3个完整模板设计案例(含设计过程分析)
- 8种WhatsApp特定异常处理对比5种基础异常
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 检查网络连接和配置后重试;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
已知限制
- 功能限制: 仅覆盖核心语法(加粗/斜体/删除线/列表),不含等宽字体、引用等高级语法(需升级付费版)
- 模板限制: 仅提供2个通知模板(订单确认/物流更新),不含客服、营销、公告模板(需升级付费版)
- 无风格规范: 不含Human-to-Human风格规范、信息层次与视觉节奏指南(需升级付费版)
- 客户端差异: WhatsApp格式渲染效果因客户端版本而异
- 不涉及消息发送: 本指南提供排版规范与模板,不涉及WhatsApp API调用
快速开始
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
需要完整模板库(客服/营销/公告)、风格规范、Markdown差异对照等高级功能?升级至 whatsapp-styling-guide 付费版,获取完整的WhatsApp排版指南与即用模板库.
评论
加载中…