公众号排版 CLI 与 Skill 功能体系 - 面向 AI Agent 的公众号创作与发布 CLI-formatted

1. 内容表达系统

Agent 公众号创作与发布 CLI，把 Markdown 排版成公众号草稿。md2wechat 覆盖微信 Markdown 编辑器、公众号排版、主题模块、封面配图、标题建议、API 转换和 md2wechat Skill，帮助人和 Agent 稳定完成公众号发布流程。

结构更稳

用统一模块把判断、证据和行动排清楚。

气质更准

让每个主题都接管清晰的品牌气质。

转化更强

让内容更容易被读完、收藏、咨询和推荐。

以上就是主题的完整排版效果展示，所见即所得。


### 🧩 按模块拆解示例

先看开场，再看信息卡、证据、图像和品牌化模块，最后看商业与收尾。信息卡族已经拆成主判断、金句、关键数字、路径、公式和诊断等类型，其它模块也都按阅读顺序单独给出示例。

#### 开场模块

先让读者知道这篇文章怎么读，再决定他要不要继续往下看。

`hero`

编辑导语型封面卡

适合观点文、深度文章和个人品牌文章，第一屏先立判断。

:::hero
variant: editorial
eyebrow: 深度观察
meta: 8 min read
kicker: 先把判断讲清楚
title: 高级排版服务阅读决策
subtitle: 主题决定气质，模块决定读者能不能看懂、记住和行动
brand: md2wechat
tags: 开场 | 判断
:::


`hero`

简报导读型封面卡

适合报告、产品分析和企业文章，先给读者三条导读。

:::hero
variant: briefing
eyebrow: 产品观察
meta: 8 min read
title: 高级排版的竞争力，不在主题，而在模块表达
subtitle: 主题决定气质，模块决定读者能不能看懂、记住和行动
points: 模块选择不足 | 信息卡不够强 | CTA 转化弱
brand: md2wechat
:::


`hero`

故事开场型封面卡

适合人物故事、案例复盘和创业经历，用场景带出主判断。

:::hero
variant: story
eyebrow: 案例复盘
kicker: 一篇草稿如何变成可发布高级稿
title: 好文章让读者更快看见重点
subtitle: 从开头判断、信息卡、证据到行动区，Agent 会先交付一版可看的结构
brand: md2wechat
:::


`cards`

横向卡片组

适合并排交代重点、章节和结构分工。


`part`

章节头

适合大段切换，不适合每个小标题都用。

:::part
index: 01
title: 模块把内容拆成更清楚的层次
subtitle: 排版与结构
:::


`toc`

目录导航

适合**长文**、**教程**和**白皮书**，先帮读者建立阅读路径。


`label-title`

标签标题

适合切换小节，让一段内容先有一个明确入口。

:::label-title
label: 模块
title: 适合用来切换小节
:::


#### 判断模块

帮助读者快速判断这篇是否适合自己、作者站在哪边、下一段为什么值得读。

`audience-fit`

适合谁

适合在开头帮读者筛选自己是不是目标读者，减少无效阅读。

:::audience-fit
title: 这篇适合谁
subtitle: 先帮读者判断要不要继续往下读
fit: 正在写长文的人 | 想建立个人品牌的人 | 需要稳定交付内容的人
avoid: 只发短讯的人 | 不需要结构化表达的人
:::


`verdict`

结论立场卡

适合把作者立场单独拎出来，让读者先知道你站哪边。

:::verdict
eyebrow: 最终判断
title: 真正的护城河来自品牌表达系统
body: 模块必须解决新的阅读任务，否则只是换皮。
note: 适合观点文、复盘、方案结论
:::


`myth-fact`

误区纠正

适合纠正常见误解，比普通对比更像观点文章的转折点。

:::myth-fact[常见误区]
模块越多越高级 | 模块越准越高级 | 数量只是覆盖面，准确才决定阅读体验
信息卡必须像海报 | 信息卡首先是一句话判断 | 图片和编号都不是必要内容
:::


`bridge`

段落桥接

适合在两个大段之间告诉读者下一段为什么重要。

:::bridge
label: 下一段为什么重要
title: 看完判断后，必须看到证据
body: 没有证据的观点只是态度，下一段用数据和案例把它撑住。
next: 继续看证据模块
:::


`manifesto`

个人宣言

适合建立个人品牌长期主张，让读者记住你反复相信什么。

:::manifesto
label: 我的长期判断
title: 我相信普通人也应该拥有自己的内容系统
body: 排版系统的价值，是让不懂设计的人也能稳定输出有识别度的文章。
believe: 结构先于风格 | 文字永远是主角 | 主题负责气质
against: 大字报式排版 | 随机堆模板 | 为装饰牺牲阅读
note: 适合个人品牌、专栏开头或结尾
:::


#### 信息卡模块

信息卡是按阅读任务组织的正文视觉摘要。

`infographic`

主判断卡

把正文里最重要的一句判断变成高级停顿点。

:::infographic
type: thesis
eyebrow: 核心判断
title: 高级排版不是装饰，是阅读决策系统
subtitle: 它先帮读者判断值不值得看，再帮作者建立记忆点
note: 适合开头后或章节收束
:::


`infographic`

公式卡

把方法论压缩成一句可记忆的公式。

:::infographic
type: formula
eyebrow: 内容公式
title: 让读者愿意读完，需要三个动作
formula: 判断 + 证据 + 行动
note: 适合方法论、课程和咨询文章
:::


`infographic`

金句卡

把一句最值得记住的话单独拎出来，形成文章记忆点。

:::infographic
type: pullquote
eyebrow: 金句
title: 好排版让判断被记住
quote: 主题负责气质，模块负责说服力。
note: 适合观点文、访谈摘录和品牌主张
:::


`infographic`

差异卡

把旧方式和新方式的关键差异压成一屏可扫读的对照。

:::infographic
type: contrast
eyebrow: 关键差异
left: 手工堆样式
right: Agent 补结构
title: 真正的升级，是从排样式变成补表达
note: 适合产品升级、竞品对比和方法论转场
:::


`infographic`

诊断卡

指出文章问题，并把读者导向解决方案。

:::infographic
type: diagnosis
eyebrow: 诊断
title: 如果文章有这三个问题，就需要高级化
items: 开头没有判断 | 中段没有记忆点 | 结尾没有行动
note: 适合服务转化文章
:::


`infographic`

关键数字卡

把最能证明价值的一个数字单独打出来。

:::infographic
type: number
eyebrow: 交付结果
value: 30min
label: 首版可见
title: 先让客户看到一版能发布的高级稿
note: 适合产品试用、服务交付和增长复盘
:::


`infographic`

发布路径卡

把从草稿到发布的关键路径压缩成可记住的步骤。

:::infographic
type: path
eyebrow: 发布路径
title: 从草稿到可发布，不再靠手工堆样式
items: 识别内容任务 | 补齐高级模块 | 输出微信 HTML
note: 适合产品价值说明和工作流介绍
:::


`infographic`

拆解卡

把一个结果拆成几个组成部分，让读者快速理解结构。

:::infographic
type: anatomy
eyebrow: 结构拆解
title: 一篇能发布的高级稿，至少要有三层骨架
items: 第一屏判断 | 中段证据 | 结尾行动
note: 适合拆解方法、产品能力和服务交付物
:::


`infographic`

取舍卡

把方案里的关键取舍讲清楚，避免用户只看到单点优势。

:::infographic
type: tradeoff
eyebrow: 方案取舍
title: 高级排版要控制选择
tradeoffs: 选择更多:更像自己 | 结构更稳:更少返工 | 动作更清:更易转化
note: 适合决策说明、产品定位和服务边界
:::


`infographic`

证据链卡

把观点背后的证据顺序排出来，让判断更可信。

:::infographic
type: evidence-chain
eyebrow: 证据链
title: 读者相信的是顺畅证据
items: 先给结论 | 再给数据 | 最后给案例
note: 适合研究文章、复盘和方案页
:::


`infographic`

微案例卡

用极短案例说明一个变化，适合在正文中段补可信度。

:::infographic
type: micro-case
eyebrow: 微案例
title: 同一篇草稿，先升级结构，再进入排版
items: 原稿只有段落 | Agent 补上信息卡和 CTA | 发布前复制 HTML
note: 适合服务案例、客户故事和产品说明
:::


#### 证据模块

先给判断，再用数据、对比、流程和时间把判断撑住。

`metrics`

数据卡

适合结果、亮点和关键数字。


`compare`

对比卡

适合讲升级、差异和前后变化，比长段解释更直接。

:::compare[旧方式 | 新方式]
手工堆样式 | 每篇都要重搭结构，容易乱 | 模块化排版 | 节奏固定，替换内容就能稳定复用
:::


`steps`

步骤流

适合流程拆解、方案落地和操作顺序说明。


`timeline`

时间线

适合讲阶段、演进和项目节奏。

:::timeline[应用场景]
品牌稿 | 开头先用封面卡 | 适合活动稿、专题稿、发布稿。
方案稿 | 中间用数据和对比 | 适合把价值和差异讲清楚。
:::


`quote`

轻量金句

适合正文中段轻轻停一下，让读者记住一句判断，不做大海报。

:::quote
variant: light
eyebrow: 核心观点
quote: 模块帮助读者更快找到判断、证据和下一步。
source: 内容设计原则
note: 适合正文中段、观点收束和短引用
:::


`quote`

品牌主张金句

适合把个人或品牌反复强调的主张单独拎出来，建立识别度。

:::quote
variant: brand
eyebrow: 品牌主张
quote: 我们不帮你做一次排版，我们帮你建立一套稳定的公众号表达系统。
brand: md2wechat
source: Agent 公众号发布引擎
note: 适合个人品牌、产品主张和专栏结尾
:::


`quote`

证据引用

适合用户反馈、采访摘录和客户证言，必须有明确来源。

:::quote
variant: proof
eyebrow: 用户反馈
quote: 真正节省时间的地方，是 Agent 已经帮我把结构排好了。
source: 企业内容负责人
role: SaaS 市场团队
context: 试用 md2wechat Agent 工作流后
source_type: customer
:::


#### 图像模块

图像模块的重点是把截图和解释放进同一个阅读区，减少来回对照。

`image-text`

图文双栏

适合教程、产品介绍和案例说明，让图和解释绑在一起。

:::image-text
layout: right
eyebrow: 功能截图
title: 图和说明绑在一起，读者更容易跟上重点
body: 左边先讲结论，右边再放真实界面，减少来回对照的成本。
note: 适合教程拆解、产品介绍和案例说明
image: https://images.unsplash.com/photo-1496171367470-9ed9a91ea931?w=800&h=1000&fit=crop
alt: 图文双栏示例图片
:::


image-`compare`

左右对比图

适合改版前后、设计优化和方案 A/B 展示。

:::image-compare
eyebrow: 前后对比
title: 左右并排时，变化会比大段解释更直接
left_title: 改版前
left_image: https://images.unsplash.com/photo-1516321318423-f06f85e504b3?w=800&h=1000&fit=crop
right_title: 改版后
right_image: https://images.unsplash.com/photo-1496171367470-9ed9a91ea931?w=800&h=1000&fit=crop
note: 适合界面改版、海报优化和方案 A/B 对比
:::


`image-annotate`

图片标注卡

适合直接告诉读者这张图该看哪里，尤其适合后台和页面拆解。

:::image-annotate
eyebrow: 拆解说明
title: 图片标注卡适合直接告诉读者重点该看哪里
note: 适合后台截图、海报拆解、页面结构分析
image: https://images.unsplash.com/photo-1558655146-d09347e92766?w=1200&h=900&fit=crop
alt: 图片标注卡示例
point: 01 | 24 | 24 | 主信息区 | 一进入页面先看到的核心判断和主标题
point: 02 | 74 | 36 | 指标区 | 适合讲关键数字、结果和变化
point: 03 | 56 | 76 | 行动区 | 适合解释按钮、入口和下一步动作
:::


`image-steps`

步骤组图

适合教学内容，把每一步的截图和说明绑定展示。


#### 品牌化模块

`author-card`

作者名片

适合在文章末尾或专栏页建立作者身份，让读者记住是谁在持续输出。

`series`

系列卡

适合专栏、连载和方法论文章，帮读者知道这不是一篇孤立内容。

:::series
name: 内容产品手记
issue: 07
title: 让每篇文章都像同一个品牌写出来
desc: 这个系列记录从排版、结构到自动化发布的完整打磨过程。
tags: 公众号 | 品牌排版 | 内容系统
next: 下一篇：个人品牌模块怎么搭
:::


适合把结尾从礼貌收束变成明确动作，但不抢正文和**总结卡**。

:::subscribe
label: 持续更新
title: 如果这篇对你有帮助，可以把这个系列收藏起来
subtitle: 我会持续更新公众号排版、AI 内容工作流和产品化复盘。
primary: 关注公众号
secondary: 转发给正在写长文的人
note: 下一篇继续拆个人品牌模块
:::


#### 商业与收尾模块

把人、价、案例、问答、工具和下一步收清楚，文章才像完整方案。

`people`

人物卡

适合团队和角色介绍，先把分工讲清楚。


`cases`

案例卡

适合展示结果和成效，建立真实信任。


`pricing`

价格卡

适合方案和报价分层，让用户判断差异。


`faq`

FAQ 区块

适合回答疑问和消除顾虑。

:::faq[常见问题]
这些模块只能在某一个主题里用吗？ | 不是，所有主题都会生效。
为什么不用硬双列？ | 因为微信正文窄，横向模块更稳。
:::


`logos`

品牌墙

适合建立信任感，补合作方或服务对象。

:::logos[合作品牌]
Northstar | 增长团队
MoriLab | 内容品牌
:::


`checklist`

检查清单

适合执行步骤和发布前核对，也很适合收藏型内容。


`toolbox`

资源工具箱

适合给模板、资料和工具入口。


`specs`

参数信息卡

适合讲对象、范围、交付和配置。


`notice`

适用说明

适合讲风险、前提和不适用场景。


`summary`

一句话总结

适合章节末尾收一句判断，保留旧写法，轻量不抢正文。

:::summary
eyebrow: 一句话总结
highlight: 先把结构搭稳，再让主题接管气质
body: 这样同一篇内容切到不同主题时，重点和节奏仍然清楚。
:::


`summary`

三点总结

适合把一节内容压成三个带走点，帮助读者快速复盘。

:::summary
variant: three
eyebrow: 三点总结
title: 这次升级重点是更会表达
items: 开场解决值不值得看 | 信息卡解决记不记得住 | CTA 解决读完后做什么
note: 适合章节末尾、复盘和观点文
:::


`summary`

决策总结

适合文章结尾告诉读者适合谁、不适合谁，以及下一步建议。

:::summary
variant: decision
eyebrow: 我的建议
title: 如果你要稳定发布，就需要 Agent 工作流
fit: 长期写公众号 | 企业内容团队 | 希望形成个人识别度的创作者
not_fit: 一次性快讯 | 只需要复制粘贴
recommendation: 先拿一篇草稿试一版，看它是否比你自己排得更完整
:::


`summary`

收藏清单总结

适合教程、方法论和可复用内容，让读者读完愿意收藏。

:::summary
variant: save
eyebrow: 发布前检查
title: 一篇高级公众号稿发布前，至少检查这 5 件事
items: 开头有没有先讲价值 | 中段有没有一个记忆点 | 证据是否支撑判断 | 总结是否能带走 | 结尾是否有明确行动
note: 适合教程、方法论和长期可复用文章
:::


`cta`

收藏关注型行动区

适合知识文、教程和个人品牌文章。

:::cta
variant: save-follow
title: 如果这篇对你有帮助，可以先收藏，再试着改一篇自己的文章。
primary: 收藏这篇
secondary: 关注更新
tertiary: 转给同事
note: 适合知识型文章
:::


`cta`

咨询转化型行动区

适合服务号、顾问文章和企业服务转化。

:::cta
variant: consult
title: 如果你也想把公众号文章做成稳定的商业交付
subtitle: 可以先从一篇文章的结构和模块开始改
primary: 咨询排版服务
secondary: 查看案例
tertiary: 收藏这篇
note: 适合服务转化文章
:::


`cta`

试用购买型行动区

适合工具产品、课程和 SaaS 文章。

:::cta
variant: trial
title: 给我一篇草稿或一个选题，先出一版可发布高级稿
primary: 试一版高级稿
secondary: 查看工作流
tertiary: 获取 API Key
note: 适合产品转化文章
:::


#### Sprint 4 新模块

信息密度更高的内容卡：提示框、引用卡、数据行、术语、推文、问答、对照、日志、资源列表。

callout

提示框

适合标注重要信息、警告、成功和危险提示。

:::callout info
重要提示：请在发布前检查所有链接是否有效。
:::


callout

提示框（警告）

适合标注需要注意的风险或限制。

:::callout warning
注意：此操作不可撤销，请谨慎操作。
:::


`quote`-card

封面引用卡

适合文章开头或结尾的大字金句展示。

:::quote-card
{“text”:“Stay hungry, stay foolish.”,“source”:“Steve Jobs，2005年斯坦福演讲”}
:::


stat-row

数据行

适合展示核心指标和关键数字。

:::stat-row
[{“value”:“99%”,“label”:“满意度”},{“value”:“3.2”,“label”:“次/日”,“unit”:“次”},{“value”:“12K”,“label”:“用户数”}]
:::


definition

术语释义卡

适合解释专业术语和核心概念。

:::definition
{“term”:“OKR”,“def”:“目标与关键结果（Objectives and Key Results），一种目标管理框架，帮助团队对齐目标并量化进展。”}
:::


tweet

推文引用卡

适合引用社交媒体上的观点或用户反馈。

:::tweet
{“name”:“张三”,“handle”:“@zhangsan”,“text”:“用了这套排版模块之后，我的公众号打开率提升了 40%，读者说结构更清晰了。”,“timestamp”:“2026-04-24”}
:::


question

问答列表

适合FAQ、读者问题解答和学习测验。

:::question
[{“q”:“这套模块适合什么类型的内容？”,“a”:“适合干货长文、教程拆解、白皮书和产品介绍，信息层次清晰时效果最好。”},{“q”:“需要会写代码才能用吗？”,“a”:“不需要，只需要学会 ::: 指令语法即可，和写 Markdown 一样简单。”}]
:::


comparison-table

优劣对照表

适合展示两个选项的优缺点对比。

:::comparison-table
{“left”:{“title”:“自建方案”,“items”:[“完全可控”,“可深度定制”,“无依赖风险”]},“right”:{“title”:“SaaS 方案”,“items”:[“初期成本高”,“维护负担重”,“扩展性受限”]}}
:::


changelog

版本更新日志

适合产品更新说明和迭代记录。

:::changelog
{“version”:“v2.1.0”,“date”:“2026-04-24”,“added”:[“新增暗色模式支持”,“多语言本地化”],“changed”:[“优化渲染性能 30%”],“fixed”:[“修复图片加载闪烁问题”],“removed”:[“移除旧版主题 API”]}
:::


resource-list

资源链接合集

适合整理参考资料、工具推荐和延伸阅读。

:::resource-list
[{“name”:“Next.js 官方文档”,“desc”:“React 全栈框架，本项目基础”,“url”:“https://nextjs.org/docs",“icon”:“📖”},{“name”:"Tailwind CSS”,“desc”:“实用优先的 CSS 框架”,“url”:“https://tailwindcss.com”,“icon”:“🎨”},{“name”:“Vitest”,“desc”:“基于 Vite 的测试框架”,“url”:“https://vitest.dev”,“icon”:“🧪”}]
:::


#### Sprint 6 新模块

自定义比例分栏、横向流程步骤、特性矩阵和双人对话——提升布局自由度和对话式内容表达。

split

比例分栏

适合自定义比例的左右分栏，两侧可放任意 Markdown 内容，图片可选。

:::split[3:2]

左栏标题

这里是左侧内容，支持 Markdown 格式，图片可选。

3. 长图兼容

3.1 📱 旧稿长图展示能力

这是兼容展示能力，不计入 47 个主推高级模块。新内容优先使用 image-text、image-compare、image-annotate、image-steps 和 infographic 组合表达。

🔤 语法格式

长图语法示例

:::longimage[产品功能介绍长图]
![功能介绍](图片URL)
:::

✨ 功能特点

支持超长图片垂直滚动浏览
420px 标准高度，移动端友好
自定义滚动条，视觉美观
五种主题样式适配

🎯 适用场景

产品功能介绍长图
数据可视化图表
流程图和操作步骤
手机截图展示

💡 使用注意事项

• 图片建议宽度至少 600px，确保清晰度
• 长图高度建议控制在 2000-5000px 范围内
• 一个长图容器只支持一张图片
• 必须包含结束标记 `:::` 才能正确解析

5. 基础对话兼容

5.1 💬 旧稿基础对话能力

这是基础兼容能力，不计入 47 个主推高级模块。新访谈、Q&A 和双人视角内容优先使用 dialogue-pair。

🔤 语法格式

对话语法示例

:::dialogue[智能客服与用户咨询]
用户: 你好，请问这个产品有什么优势？
客服: 您好！我们的产品具有操作简单、功能强大、7x24小时技术支持等优势。
用户: 价格怎么样？有优惠吗？
客服: 目前我们有新用户专享优惠，首月可享受7折优惠。
:::

✨ 设计特色

左右交替布局，模拟真实对话
圆形头像标识，自动提取首字母
气泡样式设计，符合聊天界面风格
主题色自动适配，深色模式友好

🎯 应用场景

客服对话和用户咨询
专家访谈和问答记录
教学对话和概念解释
技术讨论和方案对比

🛠️ 使用技巧

角色命名

使用简短明确的角色名，如“用户”、“客服”、“专家”等

内容编写

每句对话保持适中长度，使用自然的对话语言

场景设计

选择合适的对话标题，提供必要的上下文

⚠️ 重要注意事项

• 必须包含结束标记 `:::` 才能正确解析
• 角色名后必须有冒号（支持中英文冒号）
• 每行一句对话，避免折行影响解析
• 避免使用过长的角色名，影响布局美观

#工具

还在用原始对话框？教你用 Obsidian Canvas 与 Agent 协作上一篇

高效使用 Worktree，成为十倍程序员下一篇