# 公众号长文结构模板

## 标准结构

```
标题
├── 摘要（80-128字，概括核心价值；微信单图文 digest 上限 128 字）
├── 开头（2-3段，吸睛切入）
├── 正文主体
│   ├── 小标题一 + 段落
│   ├── 小标题二 + 段落
│   ├── 小标题三 + 段落
│   └── …（按内容需要增减）
├── 结尾（1-2段，总结 + 金句或行动号召）
└── 文末区块（引导关注、往期推荐等）
```

## 开头写法

| 类型 | 适用场景 | 示例 |
|------|---------|------|
| 提问式 | 痛点型文章 | 你有没有遇到过这样的情况：XXX？ |
| 场景式 | 故事型文章 | 上周和朋友聊天，他问了我一个问题…… |
| 数据式 | 干货/趋势型 | 据统计，80% 的人在 XXX 时会犯同一个错误。 |
| 金句式 | 观点型文章 | 有人说「XXX」，但我觉得事实恰恰相反。 |
| 直给式 | 教程/清单型 | 今天分享 5 个立刻能用的 XXX 技巧。 |

## 正文节奏

- **短段为主**：每段 3-5 行，手机阅读友好
- **节奏变化**：长短段交替，避免全篇节奏单一
- **过渡句**：小标题之间用过渡句衔接，避免割裂感

## 配图标记

在需要配图的位置插入一行 Markdown 图片语法，**占位路径固定为** `(placeholder)`（后续流程会替换为真实路径）。

### 语法结构（务必分清两段）

整体格式：

```markdown
![类型名：画面描述](placeholder)
```

方括号 `[]` 内只有一段文案，中间用**全角冒号 `：`**（U+FF1A）分成左右两部分：

| 位置 | 叫什么 | 写什么 | 作用 |
|------|--------|--------|------|
| **冒号前** | **类型名** | 只能是下表「配图类型」中的**固定词**之一（如 `氛围`、`封面`） | 给配图流程分类（封面 / 正文氛围图 / 信息图等），**不是**提示语里的泛称「类型」二字 |
| **冒号后** | **画面描述** | 用简短中文**概括画面内容**即可，不必写长段。例如「淘米」「小孩钓鱼」「窗前小口喝水」——像给图起一句**内容摘要**，读者能立刻知道「画里在干什么」 | 同时作为 **(1) 生图要点** 与 **(2) 若排版把冒号后单独成行时的图注**；须是**具体内容**，不能只是类型名（如单独「氛围」） |

**易错点（禁止）：**

- **不要把「类型」两个字当成类型名写在冒号前。** 例如 `![类型：氛围](placeholder)` 是错的：这里的「类型」只是文档里的说法，真正输出时必须写成上表中的具体词（如 `氛围`、`封面`）。
- **冒号后不能只写类型名。** 例如 `![氛围：氛围](placeholder)`、`![信息图：信息图](placeholder)` 是错的：冒号后必须是**画面内容**，让读者知道「这张图在画什么」。
- **冒号后可以很短，但不能是空泛词或类型词。** 三五字的场景概括（如「淘米」「小孩钓鱼」）完全可以；禁止只有「配图」「示意图」等敷衍词，也禁止冒号后等于类型名本身。

**对照示例：**

| 写法 | 判定 |
|------|------|
| `![氛围：淘米](placeholder)` | ✅ 简短内容概括即可 |
| `![氛围：小孩钓鱼](placeholder)` | ✅ |
| `![氛围：清晨厨房窗台一杯温水，人物小口喝水，暖色柔和光线](placeholder)` | ✅ 写长一些也可以，按需选用 |
| `![封面：透明水杯与水滴、小闹钟，宽幅留白适合标题，暖色插画](placeholder)` | ✅ |
| `![类型：氛围](placeholder)` | ❌ 误把「类型」当类型名；冒号后也不是画面内容 |
| `![氛围：氛围](placeholder)` | ❌ 冒号后不是内容，只是类型名 |

**配图密度**按 config 的 `image_density` 控制。封面图必须有。

### 配图类型（冒号前只能填这些词）

| 类型名 | 说明 | 示例标记（冒号后为画面内容，可短可详） |
|--------|------|----------------------------------------|
| `封面` | 文章封面图 | `![封面：简约科技感，蓝色调，抽象的数据连接](placeholder)` |
| `信息图` | 数据、对比、表格、流程 | `![信息图：5个工具的功能对比，列=名称/价格/特点](placeholder)` |
| `氛围` | 烘托情绪，匹配段落调性 | `![氛围：温暖的合作场景，暖色调](placeholder)` |
| `流程图` | 步骤、流程、工作流 | `![流程图：从注册到发布的3个步骤](placeholder)` |
| `对比` | 并列对比、前后对比 | `![对比：传统方式 vs AI 方式的效率差异](placeholder)` |
| `实证` | 截图、实拍（需用户提供） | `![实证：工具操作界面截图](placeholder)` |

### 标记规则

1. **封面标记**放在标题 `#` 行之前。封面图**仅用于微信文章封面**，排版时不会渲染为正文图片；配图步骤会将封面标记行移除并把封面图单独放到文章根目录。
2. **必须用图片语法** `![]()`；不能写成 `[]()`（少写 `!` 会在排版时变成普通链接）。
3. **必须独占一行**：每个配图标记单独一行，**前后各留一空行**；不要与正文挤在同一行，也不要写成「见下图：`![...](placeholder)`」。
4. **冒号前**只能是上表中的**类型名**之一，不得出现字面「类型」作为类型名。
5. **冒号后（画面描述）**用**简短内容概括**即可（如「淘米」「小孩钓鱼」），需要时也可写细一点；禁止仅用「配图」「示意图」等敷衍词，禁止冒号后等于类型名本身。
6. 信息图的**画面描述**要包含**具体数据点或维度**（方便后续做信息图类插图）。
7. 实证类须在**画面描述**里写清需提供截图/实拍，避免虚构素材。
8. **画面描述**用中文，**能短则短**，让人一眼懂画什么即可；信息图、封面等需要细节时再写具体。

## 结尾写法

| 类型 | 示例 |
|------|------|
| 总结型 | 总结一下，XXX 的关键就是这 3 点：…… |
| 金句型 | 与其等待完美时机，不如现在就开始行动。 |
| 行动号召 | 如果你也想试试，从今天开始做这一件事就够了。 |
| 互动型 | 你在 XXX 方面有什么经验？欢迎留言分享。 |

## 文末区块

按优先级加载：用户预设 > config `closing_block` > 内置默认。

**内置默认**（无任何自定义时使用）：

```markdown
---

觉得有用？点个关注，持续获取优质内容。
```

**常见自定义内容**（用户在 `.aws-article/presets/closing-blocks/` 创建）：
- 关注引导 + 公众号名片
- 作者介绍 + 品牌简介
- 往期推荐链接
- 行动号召（加群/体验小程序）
- 转载声明

## 嵌入元素标记

文章中可插入特殊嵌入标记，排版时自动替换为微信特殊标签。

| 标记 | 作用 | 示例 |
|------|------|------|
| `{embed:profile:名称}` | 插入公众号名片 | `{embed:profile:我的公众号}` |
| `{embed:miniprogram:名称}` | 插入小程序**文字链** | `{embed:miniprogram:我的小程序}` |
| `{embed:miniprogram_card:名称}` | 插入小程序**卡片**（mp-common-miniprogram） | `{embed:miniprogram_card:我的小程序}` |
| `{embed:link:名称}` | 插入往期文章链接 | `{embed:link:AI入门指南}` |

名称对应 **`.aws-article/config.yaml`** 的 **`embeds`**：名片与 `profile` 的 `nickname`（或 `name`）一致；文字链/卡片与 `miniprograms` / `miniprogram_cards` 的 `title` 一致。**仅 `{embed:link:…}`**：`related_articles.manual` 可与**本篇 `article.yaml` 的 `embeds.related_articles`** 合并（见 [topics SKILL](../../aws-wechat-article-topics/SKILL.md)）。

**常见用法**：在文末区块中嵌入名片和小程序：

```markdown
---

觉得有用？关注我，获取更多干货 👇

{embed:profile:我的公众号}

体验我们的小程序：

{embed:miniprogram:我的小程序}

{embed:miniprogram_card:我的小程序}
```