---
slug: "whatsapp-styling-guide-free"
name: "whatsapp-styling-guide-free"
version: "1.0.0"
displayName: "WhatsApp 排版入门"
summary: "WhatsApp消息排版基础指南,涵盖核心语法规则、禁用范式与基础通知模板。WhatsApp消息排版基础指南(免费版)。提供WhatsApp原生排版语法的核心规则说明、常见禁用范式与替代方案"
summary_zh: "WhatsApp消息排版基础指南,涵盖核心语法规则、禁用范式与基础通知模板。WhatsApp消息排版基础指南(免费版)。提供WhatsApp原生排版语法的核心规则说明、常见禁用范式与替代方案"
license: "MIT"
description: |-
  WhatsApp消息排版基础指南(免费版)。提供WhatsApp原生排版语法的核心规则说明、常见禁用范式与替代方案,
  以及通知类基础消息模板。覆盖三大基础能力:核心语法参考(加粗/斜体/删除线/列表的写法与效果)、
  基础禁用范式(井号标题/Markdown表格/双星号的替代方案)、基础通知模板(订单确认与物流更新).
  适用于个人开发者编写WhatsApp通知消息、日常消息排版优化等基础场景.
  如需完整模板库(客服/营销/公告)、风格规范、Markdown差异对照、内容类型排版建议等高级能力,
  请升级至whatsapp-styling-guide付费版.
tags:
  - 需求设计
  - UI设计
  - 前端
  - 设计
  - whatsapp
  - 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查看完整物流轨迹
```

**处理**: 解析基础通知模板的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回基础通知模板的处理结果,包含执行状态码、结果数据和执行日志.
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 适用场景

| 场景 | 输入 | 输出 |
|---:|---:|---:|
| 通知模板编写 | 业务通知需求(订单/物流) | 符合排版规范的WhatsApp通知模板 |
| 日常消息排版 | 需要格式化的WhatsApp消息 | WhatsApp原生格式消息 |

**不适用于**: 客服话术设计、营销消息排版、团队消息标准化(需升级付费版)

## 使用流程

1. **明确消息类型**: 确定要编写的消息属于通知还是日常沟通
2. **选择对应模板**: 从基础通知模板中选择最接近的作为起点
3. **填充业务内容**: 将模板中的变量替换为实际业务数据
4. **校验禁用范式**: 检查消息中是否使用了WhatsApp不支持的Markdown元素
5. **输出最终消息**: 输出符合排版规范的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调用

---
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

> 需要完整模板库(客服/营销/公告)、风格规范、Markdown差异对照等高级功能?升级至 **whatsapp-styling-guide** 付费版,获取完整的WhatsApp排版指南与即用模板库.