#wechat#layout

Wechat Article Writer V2

微信公众号排版文章编写。当用户需要撰写、编辑或排版微信公众号文章时使用此Skill。支持40种高级排版模块，以及标准 Markdown 基础元素

Install

openclaw skills install @suenkv/wechat-article-writer-v2

微信公众号排版文章编写

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

核心理念

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

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

语法基础

围栏块语法

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

text

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

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

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

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

text

::::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] 脚注

第四步：收尾

文章末尾按顺序放置收尾模块：

::::summary — 一句话总结（提炼核心观点）
::::author-card — 作者介绍
::::series — 系列信息（如有）
::::subscribe — 订阅/关注引导
::::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件套
不要堆砌模块：每个模块都应该解决一个明确的阅读任务，不要为了用模块而用模块

关键规则

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

完整写作示例

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

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

示例结构：