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 Recipes

先看内容要完成什么,再选少量合适的模块。适合 Agent 和 API 接入方直接参考。

Advanced Layout Recipes

这页主要讲一件事:这篇内容到底该用哪几个模块。

先记住一句话:

先看内容任务,再选少量合适的模块。

一篇文章先问自己四个问题

在选模块之前,先问:

  1. 我要不要先让读者知道值不值得继续看
  2. 这篇在手机里会不会很累
  3. 我想让读者最后记住什么判断、什么人、什么品牌
  4. 我想让读者最后做什么动作

这四个问题先想清楚,后面会好选很多。

场景 1:新版本发布稿

适合的目标:

  • 第一屏先讲这次更新到底值不值得关心
  • 中段把变化讲清楚
  • 结尾把下一步动作收住

可以先用:

  • hero
  • cards
  • compare 或 steps
  • summary
  • cta

不建议:

  • 一开头就堆 metrics、pricing、faq

场景 2:方法论长文

适合的目标:

  • 先建立判断
  • 中段让手机阅读不累
  • 结尾留下一个作者立场

可以先用:

  • verdict
  • toc
  • part
  • bridge
  • quote 或 summary
  • author-card

不建议:

  • 每个小节都用一个重模块

场景 3:教程和操作文

适合的目标:

  • 让人知道照着做就能完成
  • 在手机里不迷路
  • 避免长段说明压垮阅读

可以先用:

  • hero
  • steps
  • image-text 或 image-steps
  • notice
  • checklist

不建议:

  • 用大量观点模块打断操作节奏

场景 4:服务页或成交页

适合的目标:

  • 先筛人
  • 再讲差异
  • 最后把信任和行动收住

可以先用:

  • audience-fit
  • verdict
  • cases
  • pricing
  • faq
  • subscribe 或 cta

不建议:

  • 一上来先讲自己多厉害,不先告诉读者适不适合他

场景 5:品牌和专栏文章

适合的目标:

  • 让读者记住你的判断
  • 让读者记住你是谁
  • 让读者愿意继续跟

可以先用:

  • hero
  • manifesto
  • quote
  • series
  • author-card
  • subscribe

不建议:

  • 把文章写成公司介绍页

Agent 最稳的选型顺序

如果你在写 Agent 规则,可以先按这个顺序来:

  1. 先判断内容属于发布、教程、方法论、服务页还是品牌稿
  2. 先选一个开场模块
  3. 再选一到两个承载正文的模块
  4. 最后选一个收尾模块

多数文章走到这里就够用了。

一个很实用的上限

如果不是白皮书或长指南,一篇文章通常控制在:

  • 3 到 6 个高级模块

太少,结构可能不明显。
太多,正文容易被切碎。

最后一句判断

高级排版不是把文章搞复杂。

它要做的,只是帮普通作者和 Agent 更稳地把重点、节奏和动作收进同一篇文章里。

接下来可以继续看:

  • Advanced Layout
  • Advanced Layout Use Cases
  • Advanced Layout Syntax
  • Advanced Layout Mistakes
  • Discovery-First Workflow
  • Convert

doctor 与 inspect 准备状态

使用 doctor 和 inspect 的准备状态输出,在预览、转换、上传或创建草稿前判断当前任务是否可以继续。

Article Draft

直接从 Markdown 创建图文消息草稿。

目录

Advanced Layout Recipes
一篇文章先问自己四个问题
场景 1:新版本发布稿
场景 2:方法论长文
场景 3:教程和操作文
场景 4:服务页或成交页
场景 5:品牌和专栏文章
Agent 最稳的选型顺序
一个很实用的上限
最后一句判断