md2wechat已有 Markdown 文章时，先安装 md2wechat CLI、配置转换服务，再生成 HTML 预览。确认文章、封面和公众号配置后，才继续创建草稿；创建草稿不会自动群发。
本文按 CLI v3.8.0 核对。命令和结果说明见 v3.8.0 使用文档；本机版本不同，先查 --help。这里的预览步骤可以独立完成，不要求提前填写微信凭证。
安装在实际执行命令的环境里
准备可用的 Node.js 和 npm，执行：
npm install -g @geekjourneyx/md2wechat
md2wechat version --json
md2wechat capabilities --json
version 返回安装版本，capabilities 返回可用能力。如果出现 command not found，先按安装排障检查命令路径。
让 Agent 操作时，CLI 和文章必须在它能访问的环境中。Agent 在远程环境执行命令，就在远程环境安装；只在自己电脑上装好，不能证明 Agent 能调用。安装 Skill 只增加操作规范，不能替代 CLI。
没有 npm 时，可以按 Release 安装说明选择对应系统的文件。不要把其他系统的二进制当作本机程序运行。
按需初始化，保留已有配置
第一次使用、尚无配置时执行：
md2wechat config init
已有配置就保留，先查看当前生效配置和本地检查结果：
md2wechat config show --format json
md2wechat doctor --json
默认 API 模式需要有效的转换 API Key。初始化配置不会自动开通服务；申请方式见获取 API Key。按CLI 手册填写转换服务配置，不要把密钥写进文章或提交到公开仓库。
doctor 检查本地配置是否具备尝试条件，不会联网证明密钥有效，也不上传图片或创建草稿。微信 AppID / AppSecret、转换 API Key 和图片生成服务密钥承担不同任务，不要互换。
准备一份简单文章
把下面内容保存为 UTF-8 编码的 article.md：
# 我的第一篇公众号文章
这份样稿用于检查标题、正文和列表的排版。
## 今天想说什么
- 用 Markdown 保存正文
- 先检查排版结果
- 确认后再准备公众号草稿
先检查文章，再生成预览。article-preview.html 使用一个新文件名，保留原稿：
md2wechat inspect article.md --json
md2wechat preview article.md --output article-preview.html --json
inspect 返回文章信息、检查项和 data.readiness.targets / data.readiness.blockers。按当前目标查看阻碍项：缺少微信凭证会影响上传或草稿目标，不应据此判断普通预览一定失败。
预览成功后，核对返回的 data.output_file，打开这个文件，查看标题层级、正文、列表和手机阅读效果。成功结果是可读取的 HTML；不要把 JSON 响应本身粘贴进公众号编辑器。这一步可能调用转换服务，但不上传素材、不创建公众号草稿。
为什么 AI 模式没有直接生成 HTML
API 模式向转换服务请求 HTML。AI 模式可能返回 status=action_required 和供 Agent 处理的提示词，后续仍由 Agent 完成；它不保证命令运行完就得到预览。
如果预览返回 PREVIEW_ACTION_REQUIRED 或 PREVIEW_FAILED，本次没有创建或覆盖预览文件。即使同名 HTML 以前存在，也不能当作这次的结果；查看返回状态及 data.output_file 再决定下一步。首次接入可先跑通默认 API 预览，避免把提示词误认成成品。
预览完成后，怎样进入公众号草稿箱
准备当前公众号的 AppID / AppSecret、适用的 IP 白名单和封面，核对正文图片是否需要上传。先确认目标账号、文章和封面，再明确授权创建草稿。
完整操作见 Markdown 到公众号草稿工作流。如果需要程序直接接入，查阅公众号发布 API 说明。中文站 POST /api/convert 只生成 HTML，不会创建草稿。
草稿操作返回成功后，进入公众号后台检查标题、正文、图片和封面。遇到超时先查草稿箱与返回结果，不要立即重复创建。正式发布或群发按公众号权限和微信流程另行完成。
下一步按任务查文档
- 让 Agent 排版：公众号排版 Skill 手册。
- 查命令和参数：命令与能力大全。
- 选择主题：主题画廊，再按本机能力查询选择可用主题。
- 学高级排版：高级排版模块指南。
- 保存知乎、CSDN、头条或腾讯云草稿：多平台草稿教程，按目标平台单独核对。