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

开始

Markdown 转微信公众号 API 文档QuickstartAuth

接口

API OverviewThemeConvertAdvanced LayoutMode SelectionAdvanced Layout Use CasesAdvanced Layout SyntaxAdvanced Layout MistakesDiscovery-First Workflowdoctor 与 inspect 准备状态Advanced Layout RecipesArticle DraftNewspic DraftBatch Upload

接入

运维

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

Convert

把 Markdown 转成微信可粘贴 HTML。

Mode Selection

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

目录

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