md2wechat Agent API markAgent API 文档
md2wechat Agent API markAgent API 文档
首页

开始

Markdown 转微信公众号 API 文档QuickstartAuth

接口

API OverviewThemeConvert发布 API微信 IP 白名单多账号发布图片生成标题生成封面图Advanced LayoutMode SelectionAdvanced Layout Use CasesAdvanced Layout SyntaxAdvanced Layout MistakesDiscovery-First Workflowdoctor 与 inspect 准备状态Advanced Layout Recipes排版模块目录

接入

运维

ErrorsPricingContact
X (Twitter)
API

Advanced Layout

这页先讲高级排版模块到底在处理什么问题,再讲什么时候该用、什么时候不必用,以及第一次接入该从哪几页开始看。

Advanced Layout

高级排版模块不是给 Markdown 多加几个样式。

它处理的是另一层问题:一篇内容怎么更容易被看完,怎么更容易留下印象,最后怎么把动作带出来。

这套能力到底在解决什么

不管你写的是教程、方案、发布稿还是服务页,排版模块最终都只该服务四件事:

  1. 让读者先知道这篇值不值得看
  2. 让读者在手机窄屏里不累
  3. 让读者记住一个判断、一个人、一个品牌
  4. 让读者读完后愿意收藏、关注、咨询、转发或购买

如果一个模块和这四件事都没关系,通常就没必要放进去。

什么时候最值得接

如果你写的是下面这些内容,这套东西通常很值:

  • 新版本发布稿
  • 教程和操作文
  • 方法论长文
  • 服务介绍页
  • 机构或个人品牌内容

这些内容有一个共同点:它们不只是要排出来,还要有人看完,还要让人记住点什么。

什么时候不用急着上

下面这些情况,先用普通 Markdown 往往就够了:

  • 内容很短,只想发一条简单消息
  • 还在验证题材,不想先引入额外结构
  • 重点问题还在“写什么”,不是“怎么讲”

为什么这对 Agent 很重要

对人来说,排版乱一点,最多只是看着别扭。

对 Agent 来说,排版语法如果没有边界,问题会更大:

  • 会把模块写成普通正文
  • 会用太多模块,把文章切碎
  • 会字段写错,最后整块不渲染
  • 会把“想表达什么”让位给“想把模块都用上”

所以这套语法最有用的地方,不是更花,而是更稳。

它让 Agent 不用懂设计,也能把结构先搭对。

模块和主题的分工

这件事最好分开看:

  • 主题负责气质
  • 模块负责说服力

主题解决的是“这篇看起来像什么类型内容”。

模块解决的是“重点先不先出来、手机里累不累、读者最后记住什么、愿不愿意行动”。

如果只换主题,不换结构,很多文章还是会显得平。

如果只有结构,没有主题,文章也能读,只是识别度会弱一点。

最该先学的,不是 38 个模块

你不需要一上来背全部模块。

更实用的做法,是先熟这几类:

  • 开场模块:先交代值不值得看
  • 判断模块:先把立场和结论说清楚
  • 证据模块:再补数据、步骤和对比
  • 收尾模块:最后把品牌和行动收住

先把这条线用顺,已经够覆盖大部分公众号内容。

第一次接,先别想着把模块用全

更稳的顺序是:

  1. 先确定内容任务
  2. 先选一个开场模块
  3. 再选一到两个承载正文的模块
  4. 最后选一个收尾模块

大多数文章到这里就够了。

推荐阅读顺序

如果你准备把这套语法真正接进工作流,建议继续看:

  1. Mode Selection
  2. Advanced Layout Use Cases
  3. Advanced Layout Syntax
  4. Advanced Layout Mistakes
  5. Discovery-First Workflow

封面图

草稿必须有显式封面——两种入参、校验、生成方式与 hero 的区别。

Mode Selection

先把 API 模式、AI 模式、普通转换和高级排版的分工看清楚,少走弯路。

目录

Advanced Layout
这套能力到底在解决什么
什么时候最值得接
什么时候不用急着上
为什么这对 Agent 很重要
模块和主题的分工
最该先学的,不是 38 个模块
第一次接,先别想着把模块用全
推荐阅读顺序