md2wechat 常用命令入门：排版、写作与图片

本文介绍常用命令的使用场景。完整命令、子命令和参数请查阅命令与能力大全，本页不作为完整清单。

当前版本的产品介绍、百科草稿和平台定向写作优先使用定向写作指引。write、humanize 和 title suggest 返回的写作请求仍需 Agent 处理，不能把提示词当作已完成的稿件。

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

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

一张表先看全局

命令	解决什么问题	什么时候用
convert	把 Markdown 转成微信 HTML，或继续发草稿	你已经有 Markdown 成稿
write	从想法、观点或片段出发辅助生成文章	你还没有完整正文
humanize	准备自然表达润色请求	你已经有 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 先帮你出结构、标题、封面提示词。

典型写法

先将文章提纲保存为 outline.md，再准备写作请求：

md2wechat write --input-type outline outline.md --json

正确理解

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

你可以把链路理解成：

1. write
2. humanize（可选）
3. convert
4. convert --draft（已确认正文、公众号与封面后）

3. humanize：准备自然表达润色请求

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

需要修改表达时，可以准备润色请求交给 Agent；命令本身不返回润色后的成稿：

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. 图片生成相关命令

先查询当前图片服务和预设。下面使用计划模式，只返回图片生成意图，交给 Agent 图片工具处理：

md2wechat generate_cover --article article.md --plan --json
md2wechat generate_infographic --article article.md --preset infographic-comparison --plan --json
md2wechat generate_image --preset cover-hero --article article.md --plan --json

直接生成需要图片服务与公众号凭证，并会把生成结果上传到微信素材库；不会自动写回原稿。

怎么选？

• 只做封面：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 接入指南