md2wechat 命令大全：convert、write、humanize、themes、prompts 怎么用

如果你已经把 md2wechat 装好了，这篇可以当速查表。

这篇按“你在真实工作流里会怎么想”来拆命令：

1. 我已经有 Markdown，要排版。
2. 我还没有正文，想让它帮我写。
3. 我正文已经有了，但太像 AI 写的。
4. 我想生成封面图、信息图或图片内容。
5. 我不确定有哪些主题、Provider、Prompt 可以用。

一张表先看全局

命令	解决什么问题	什么时候用
convert	把 Markdown 转成微信 HTML，或继续发草稿	你已经有 Markdown 成稿
write	从想法、观点或片段出发辅助生成文章	你还没有完整正文
humanize	去掉 AI 腔，让文字更自然	你已经有 AI 生成稿
create_image_post	创建图片消息 / 小绿书内容	你的内容是图片型，不适合长文链路
capabilities --json	查看当前能力总表	Agent 场景里先探测能力
providers list --json	查看可用 Provider	选图像或模型前先查
themes list --json	查看主题	不要凭记忆猜主题名
prompts list --json	查看提示词模板	需要封面图、信息图模板时用

1. convert：已有 Markdown 时的主力命令

这是最核心的命令。

最常用写法

md2wechat convert article.md --preview

适合先看结果，不直接碰草稿箱。

AI 模式预览

md2wechat convert article.md --mode ai --theme autumn-warm --preview

适合你想先看更风格化的输出。

直接发草稿

md2wechat convert article.md --draft --cover cover.jpg

这一步是“排版 + 推送草稿”的组合动作，更适合你已经确认内容、封面和公众号配置都没问题的时候。

2. write：从想法开始

README 里其实已经把 write 和 convert 的差异讲得很清楚：

• write：从想法出发，帮你组织文章结构。
• convert：从现成 Markdown 出发，帮你做发布层排版。

适合 write 的场景

• 只有一个主题，没有正文。
• 你知道观点，但不知道怎么展开。
• 你希望 Agent 先帮你出结构、标题、封面提示词。

典型写法

md2wechat write --idea "写一篇关于 AI Agent 自动发布微信公众号的文章"

正确理解

write 在 convert 前面补了一层创作能力。

你可以把链路理解成：

1. write
2. humanize（可选）
3. convert
4. draft

3. humanize：去掉 AI 腔

很多人内容其实已经差不多了，问题不在事实，而在语气和句型太像模型输出。

这时更适合用：

md2wechat humanize article.md

什么时候该用

• 大量“首先、其次、最后”。
• 大量模板化排比。
• 句子太平，没有人的呼吸感。
• 内容虽然正确，但不像你自己的语气。

什么时候不该用

• 原文已经是成熟作者风格。
• 你只是想转 HTML，不打算改内容。
• 文章已经通过人工精修。

4. create_image_post：做图片消息 / 小绿书内容

如果你想做图片型内容，就不该继续沿用纯文章链路。

md2wechat create_image_post

这类内容更适合：

• 多图卡片
• 小绿书样式内容
• 图文并重的短内容

5. discovery-first：Agent 场景的关键习惯

md2wechat 的 skill 文档里强调得很明确：不要靠猜。

先看能力

md2wechat capabilities --json

先看 Provider

md2wechat providers list --json

先看主题

md2wechat themes list --json

先看 Prompt

md2wechat prompts list --json

如果你在 Agent 里工作，这四条命令很重要。它们能减少大量“模型记错命令名”“猜错主题名”“想当然用不存在模板”的问题。

6. Prompt 系列命令怎么理解？

当你开始做封面图、信息图、图文视觉风格时，Prompt 就成了工作流的一部分。

列出图片相关 Prompt

md2wechat prompts list --kind image --archetype cover --json

查看某个 Prompt 详情

md2wechat prompts show cover-default --kind image --json

直接渲染一个 Prompt

md2wechat prompts render cover-default --kind image --var article_title='Example' --json

什么时候要先看 Prompt？

• 你在做封面图。
• 你在做信息图。
• 你要根据风格模板切换视觉方向。
• 你准备把图像生成纳入 Agent 工作流。

7. 图片生成相关命令

如果你已经不满足于只有文字排版，这几条命令要尽快熟悉：

md2wechat generate_cover --article article.md
md2wechat generate_infographic --article article.md --preset infographic-comparison
md2wechat generate_image --preset cover-hero --article article.md --model gemini-3-pro-image-preview

怎么选？

• 只做封面：generate_cover
• 做信息图：generate_infographic
• 已经知道某个预设，直接生成：generate_image

8. 配置优先级别搞反

skill 里写得很清楚，配置优先看这几层：

1. ~/.config/md2wechat/config.yaml
2. 环境变量
3. 项目本地 md2wechat.yaml / md2wechat.yml / md2wechat.json

如果你想改 API 域名，改：

• api.md2wechat_base_url
• 或 MD2WECHAT_BASE_URL

默认主域名：

• https://www.md2wechat.cn

备用域名：

• https://md2wechat.app

9. 我建议你把命令分成三组记

创作组

• write
• humanize

发布组

• convert
• convert --draft
• create_image_post

发现组

• capabilities --json
• providers list --json
• themes list --json
• prompts list --json

这样比死记参数更实用。

10. 最后给你一个推荐顺序

如果你要正式把 md2wechat 用起来，我建议按这个顺序练：

md2wechat convert article.md --preview
md2wechat themes list --json
md2wechat convert article.md --mode ai --theme autumn-warm --preview
md2wechat humanize article.md
md2wechat convert article.md --draft --cover cover.jpg

先把这五步跑顺，再去学 Prompt、Provider 和图片生成。

下一篇建议读：

• Coding Agent 接入指南
• OpenClaw 接入指南