Wechat Article Writer V2

SKILL.md

---
name: wechat-article-writer-v2
description: 微信公众号排版文章编写。当用户需要撰写、编辑或排版微信公众号文章时使用此Skill。支持40种高级排版模块，以及标准 Markdown 基础元素
description_zh: 写公众号长文、品牌发布稿、教程拆解、方案介绍、产品说明等需要结构化排版的内容。
tags: 公众号文章、微信排版、写一篇公众号、公众号长文、品牌发布稿、教程文章、方案介绍等。
author: 森林（你好森林）· suenty@foxmail.com
version: 2.1.0
---

# 微信公众号排版文章编写

当用户需要编写微信公众号文章时，使用本 Skill 指导 Markdown 写作。

## 核心理念

这套排版系统的理念是：**模块负责信息骨架，主题负责阅读气质**。

不是简单把 Markdown 转成微信格式，而是把标题、正文、排版模块、主题和行动放进同一套标准里，让一篇内容既有气质也有说服力。

## 语法基础

### 围栏块语法

所有模块使用 `::::模块名[可选标题]` ... `::::` 语法包裹。

```
::::模块名[可选标题]
字段: 值
...
::::
```

- 开头必须是 `::::模块名`（固定4个冒号），模块名后可跟 `[标题]`
- 结尾单独一行 `::::`（固定4个冒号，与开头一致）
- 块内空白行会被忽略

### 元信息模块（不产生视觉输出）

`::::title` 和 `::::digest` 是**元信息模块**，用于显式指定文章的标题和摘要。它们不会被渲染为 HTML，仅用于设置元数据。

```
::::title
你的文章标题（不依赖 YAML frontmatter 或 # 标题自动提取）
::::

::::digest
你的文章摘要，会在分享时显示（不依赖自动截取前80字）
::::
```

- 块内为纯文本，不需要 key: value 格式
- **优先级最高**：会覆盖 YAML frontmatter 和自动提取
- 放在文章开头处，会在转换时自动提取并融入 HTML `<title>` 和 `<meta description>`
- 如果未使用这些模块，转换器会自动从 `# 标题` 和正文第一段提取标题和摘要

### 两种数据格式

- **Key-Value**：`key: value`，每行一个字段
- **Pipe-Delimited**：`字段1 | 字段2 | 字段3 | ...`，用 `|` 分隔，`|` 前后空格会自动去除

### 内联格式

所有字段的文本均支持 Markdown 内联语法：
- `**粗体**` → 粗体（金色高亮）
- `*斜体*` → 斜体
- `~~删除线~~` → 删除线
- `` `代码` `` → 行内代码
- `[文字](url)` → 超链接

---

## 编写流程

### 第一步：分析文章内容，选择模块组合

拿到一篇文章后，先分析其**内容类型**和**信息密度**，然后选择合适的模块组合。

**文章类型 → 推荐模块组合：**

| 内容类型 | 推荐模块结构 | 核心思路 |
|---------|-------------|---------|
| 品牌发布/产品上新 | hero → metrics → infographic → image-text → cta | 先给结论，用数据支撑，用图文强化，最后引导行动 |
| 教程/操作指南 | hero → toc → image-steps → checklist → faq → subscribe | 先给导航，步骤配图，清单检查，答疑收尾 |
| 方案/提案/汇报 | hero → verdict → metrics → image-compare → cases → cta | 先出判断，数据举证，对比差异，案例佐证 |
| 个人复盘/思考 | hero → quote → infographic → author-card → series → subscribe | 先抛观点，引用金句，信息图总结，个人品牌收尾 |
| 工具推荐/资源合集 | hero → toolbox → specs → logos → cta | 先亮工具，分类推荐，参数对比，品牌背书 |
| 技术文章/深度解读 | hero → toc → infographic × N → verdict → summary → subscribe | 目录导航，分段设卡，一段一判断，总结收束 |
| 活动/课程推广 | hero → pricing → people → faq → cta | 先吸引眼球，方案对比，团队介绍，答疑促转 |
| 年度/季度总结 | hero → metrics → cases → summary → series → subscribe | 数据先行，案例回顾，总结展望，系列承上启下 |

### 第二步：搭骨架，先写元信息和模块占位

不要一开始就写完整内容。先在 Markdown 中放置元信息模块（**必须包含** `::::title` 和 `::::digest`）和核心模块的占位符：

```markdown
::::title
XX工具：让公众号排版效率翻3倍的Markdown引擎
::::

::::digest
用40种模块搭骨架，用主题控制气质，一键导出微信兼容HTML。排版时间从2小时降到10分钟。
::::

# 文章大标题（如果用了 ::::title 则此处可选）

::::hero
title: 核心主张 | 亮点关键词
...
::::

## 为什么这件事重要

正文段落...

::::metrics[关键数据]
...
::::

正文段落...

::::verdict
...
::::

::::cta
...
::::
```

### 第三步：填充正文和模块内容

> **必须先读取 `references/module_reference.md`**：在填写任何模块字段之前，必须读取参考文档，确认每个模块的精确字段名、必填项和列结构。不要凭记忆猜测字段名，不同模块的字段差异很大，猜错会导致渲染失败。

在模块之间穿插标准 Markdown 正文：
- `# ~ ######` 标题层级
- 段落之间用空行分隔
- `- 列表` 或 `1. 有序列表`
- `> 引用` 和 `> [!NOTE]` 等 GFM 提示框
- ` ```语言 代码块 ``` `
- `![alt](url)` 图片
- `---` 分隔线
- `[^1]` 脚注

### 第四步：收尾

文章末尾按顺序放置收尾模块：
1. `::::summary` — 一句话总结（提炼核心观点）
2. `::::author-card` — 作者介绍
3. `::::series` — 系列信息（如有）
4. `::::subscribe` — 订阅/关注引导
5. `::::cta` — 最终行动号召

---

## 各模块适用场景速览

详细的每个模块字段说明见 `references/module_reference.md`。以下按使用场景归类，帮助快速选模块：

### 开头区（文章前1/3）

| 模块 | 什么时候用 |
|------|-----------|
| **hero** | 任何文章的**默认开头**，放主标题、副标题、封面图 |
| **toc** | 长文章（2500字+）或教程，给读者一个"阅读地图" |
| **label-title** | 需要给正文章节加标签标识时，做视觉分隔 |
| **part** | 将长文分成 P1/P2/P3 几个大段落 |

### 核心论证区

| 模块 | 什么时候用 |
|------|-----------|
| **infographic** | 想把**一个关键判断**做成视觉冲击的摘要卡 |
| **verdict** | 给出**结论性判断**，适合"一句话说清楚" |
| **quote** | 引用金句、名言、用户反馈、采访摘录 |
| **metrics** | 用**数据指标**支撑论点（3-6个卡最佳） |
| **image-compare** | 前后对比、方案A/B对比、改版对比 |

### 信息整理区

| 模块 | 什么时候用 |
|------|-----------|
| **cards** | 分类展示几个并列的概念/功能/步骤 |
| **faq** | 常见问题答疑 |
| **checklist** | 待办清单、检查项、任务列表 |
| **specs** | 参数规格、配置说明、技术指标 |
| **notice** | 适用说明、注意事项、风险提示 |
| **pricing** | 方案/版本/套餐对比（不限于价格） |
| **logos** | 客户Logo墙、合作品牌展示 |

### 视觉展示区

| 模块 | 什么时候用 |
|------|-----------|
| **image-text** | 图片+说明文字并排（教程截图、产品图） |
| **image-steps** | 步骤配图，每个步骤一张图+说明 |
| **image-annotate** | 在图片上标注重点区域 |
| **gallery** | 横向滑动浏览多张图片 |
| **longimage** | 长图/架构图等需要滚动查看的图片 |
| **dialogue** | 对话/访谈/聊天记录 |

### 人物与案例区

| 模块 | 什么时候用 |
|------|-----------|
| **people** | 团队介绍、角色分工、人物介绍 |
| **cases** | 案例展示、成功案例、项目回顾 |
| **audience-fit** | 明确"适合谁/不适合谁" |
| **toolbox** | 工具/资源/链接推荐 |

### 收尾区

| 模块 | 什么时候用 |
|------|-----------|
| **summary** | 文章末尾的**一句话总结** |
| **author-card** | 作者信息名片 |
| **series** | 系列文章导航（第X期） |
| **subscribe** | 关注引导/下期预告 |
| **cta** | 最终行动号召 |

### 微信原生组件

| 模块 | 什么时候用 |
|------|-----------|
| **profile** | 插入公众号名片（需真实公众号ID） |
| **videosnap** | 插入视频号卡片（需真实视频号信息） |
| **mpaudio** | 插入音频播放器 |
| **vote** | 插入投票组件 |
| **search** | 插入搜索组件 |
| **answer-card** | 问答卡片（Q&A 展示） |
| **wechat-blockquote** | 微信原生引用样式 |

---

## 模块数量原则

- **短文章（800-1500字）**：2-4 个模块，hero + 1-2 个论证 + cta
- **中文章（1500-3000字）**：3-6 个模块，hero + toc + 2-3 个论证 + 收尾2件套
- **长文章（3000字+）**：5-8 个模块，hero + toc + part × N + infographic × N + 收尾3件套
- **不要堆砌模块**：每个模块都应该解决一个明确的阅读任务，不要为了用模块而用模块

---

## 关键规则

1. **图片使用完整 HTTPS URL**，不要用本地路径。测试可用 `https://picsum.photos/seed/{任意词}/{宽}/{高}`
2. **title 中用 `|` 实现高亮**：
   - hero 中：`模块负责骨架 | 主题负责气质` → "主题负责气质" 金色高亮
   - infographic 中：`让|一句判断|先被看到` → "一句判断" 金色下划线+背景
3. **pipe 模块的行样式控制**：需要 `accent`/`default` 的模块（cards/metrics/people/cases/pricing）在最后加一列
4. **模块间距**：模块之间建议插入至少一段正文或一个二级标题，避免模块堆叠
5. **文章标题与摘要必须显式指定**：
   - **每篇文章必须包含 `::::title` 和 `::::digest` 元信息模块**，放在文章最开头
   - 不依赖自动提取——即使写了 `# 标题` 和正文，也必须在 `::::title` / `::::digest` 中显式设置
6. **固定使用4个冒号** `::::`，开头和结尾都必须是4个冒号，不要用其他数量

---

## 完整写作示例

当用户说"帮我写一篇介绍 xx 工具的公众号文章"时：

1. **确认文章类型** → 工具推荐类
2. **选择模块结构** → hero → infographic → image-steps → metrics → summary → subscribe → cta
3. **先搭骨架** → 把所有模块占位符写出来
4. **填充内容** → 填入标题、描述、数据，穿插正文
5. **输出 .md 文件** → 可直接用脚本转 HTML

示例结构：
```markdown
::::title
XX工具：让公众号排版效率翻3倍的Markdown引擎
::::

::::digest
用38种模块搭骨架，用主题控制气质，一键导出微信兼容的HTML，排版时间从2小时降到10分钟。
::::

# XX工具：让公众号排版效率翻3倍的Markdown引擎

::::hero
eyebrow: 效率工具
kicker: 告别手动排版
title: 用Markdown写出 | 微信公众号文章
subtitle: 40种高级模块 + 一键转换HTML，排版时间从2小时降到10分钟
image: https://picsum.photos/seed/hero/800/400
brand: md2wechat
tags: Markdown | 微信排版 | 效率工具
::::

## 为什么需要这个工具

传统公众号排版依赖可视化编辑器手动拖拽，一篇长文排版动辄2小时，而且不同文章的排版风格难以统一。更痛的是，改一个模块的样式意味着要把所有历史文章都手动改一遍。

这套 Markdown 排版引擎把排版逻辑从"手动操作"变成了"写结构化文本"——用 40 种模块搭骨架，用主题控制气质，一次写好就能一键导出微信兼容的 HTML。

::::infographic
eyebrow: 核心价值
title: 把|排版时间|还给内容创作
subtitle: 不是又一个编辑器，而是一套完整的内容生产系统
note: 适合每天需要发布公众号文章的内容创作者
::::

过去写一篇文章，排版和内容的时间比大概是 **1:1**——写1小时，排1小时。用了模块化方案后，排版时间压缩到10分钟以内，因为模块的字段是确定的，写内容的时候排版结构就自然成型了。

::::image-steps[三步完成排版]
01 | 写Markdown | 用熟悉的语法写内容，40种模块随意组合 | https://picsum.photos/seed/step1/800/400 | 支持标准Markdown语法
02 | 选主题 | 一键切换配色方案 | https://picsum.photos/seed/step2/800/400 | 内置多种主题
03 | 导出HTML | 复制到公众号后台即可发布 | https://picsum.photos/seed/step3/800/400 | 格式完美兼容
::::

三个步骤里，第一步和第二步几乎不花时间，真正省下来的是第三步——不用再在公众号后台反复调整格式，复制粘贴即所见即所得。

::::metrics[实测效果]
排版耗时 | -85% | 从2小时降到10分钟 | accent
模块复用 | 47个模板 | 一次配置永久使用 | default
阅读完成率 | +38% | 结构清晰读者更愿意看完 | default
::::

::::summary
eyebrow: 一句话总结
highlight: Markdown排版引擎让公众号创作回归内容本身，排版全部自动化
body: 40个高级模块、一键主题切换、完美微信兼容，让每篇文章都像专业团队出品
::::

::::subscribe
label: 持续更新
title: 如果你也想用Markdown写公众号
subtitle: 关注我获取最新模块更新和使用技巧
primary: 关注公众号
secondary: 分享给朋友
::::

::::cta
title: 开始用Markdown写你的下一篇公众号文章
note: WRITE WITH STRUCTURE
::::
```

---

## 输出规范

- 最终输出为 `.md` 文件，保存到用户指定目录或当前工作目录
- 文件内容使用上述围栏块语法 + 标准 Markdown 编写
- 图片必须使用完整 HTTPS URL，不要用本地路径
- **每篇文章必须包含 `::::title` 和 `::::digest` 元信息模块**，放在文件开头
- 如未使用元信息模块，第一个 `# 标题` 会自动提取为文章标题（仅作为降级处理，不替代显式设置）
- 不要在文件中包含 HTML 标签，只写 Markdown 和围栏块