微信公众号排版文章编写
当用户需要编写微信公众号文章时，使用本 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）和核心模块的占位符：
::::title
XX工具：让公众号排版效率翻3倍的Markdown引擎
::::
::::digest
用40种模块搭骨架，用主题控制气质，一键导出微信兼容HTML。排版时间从2小时降到10分钟。
::::
# 文章大标题（如果用了 ::::title 则此处可选）
::::hero
title: 核心主张 | 亮点关键词
...
::::
## 为什么这件事重要
正文段落...
::::metrics[关键数据]
...
::::
正文段落...
::::verdict
...
::::
::::cta
...
::::
第三步：填充正文和模块内容
> 必须先读取 references/module_reference.md：在填写任何模块字段之前，必须读取参考文档，确认每个模块的精确字段名、必填项和列结构。不要凭记忆猜测字段名，不同模块的字段差异很大，猜错会导致渲染失败。
在模块之间穿插标准 Markdown 正文：
- # ~ ###### 标题层级
- 段落之间用空行分隔
- - 列表 或 1. 有序列表
- > 引用 和 > [!NOTE] 等 GFM 提示框
- ```语言 代码块 ```
-  图片
- --- 分隔线
- [^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件套
- 不要堆砌模块：每个模块都应该解决一个明确的阅读任务，不要为了用模块而用模块
关键规则
- 图片使用完整 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
示例结构：
::::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 和围栏块
