md2wechatMD2WeChat Publisher 把公众号排版预览放在 Obsidian 的笔记旁。你可以选择主题、调整字号、修改原文后刷新，并在确认公众号、封面和文章信息后创建草稿。
这份教程对应插件 2.0.0。先看产品介绍与环境要求，需要购买排版服务时查看费用范围。已有 Key 的用户先校验配置与权益，不必直接重复购买。
安装与配置
准备桌面环境
- 桌面 Obsidian 1.12.7 或更高版本，不支持移动端。
- 安装主 CLI
@geekjourneyx/md2wechat。本版以 CLI 3.5.0 验证。 - macOS 已实测预览、刷新、切换文章和真实草稿创建；Windows / Linux 尚未实测。
- 直接使用插件不需要 Agent。Agent 接入才额外要求 Obsidian 官方命令行与相应技能。
安装并校验 md2wechat
在终端执行：
npm install -g @geekjourneyx/md2wechat
md2wechat version --json
md2wechat config init --json
md2wechat config validate --json
按向导配置服务。已有配置时先查看版本并校验，不必重复初始化。API 模式需要有效排版服务 Key；创建草稿还需要目标公众号账号和凭证。详细字段与白名单要求见主 CLI 手册。
| 配置 | 用途 | 管理位置 |
|---|---|---|
| 排版服务 API Key | API 模式的 Markdown 排版 | md2wechat CLI 配置 |
| 微信 AppID / AppSecret | 图片上传与公众号草稿操作 | md2wechat CLI 配置 |
| 外部 Agent 或图片模型服务 | 按需使用外部能力 | 对应工具或服务配置 |
插件 2.0 不需要在插件设置内填写接口地址和密钥。不要把凭证写进正文或截图。排版预览可能调用配置的在线转换服务；“笔记保存在本地”不代表所有处理都离线完成。
安装插件 ZIP
- 打开 2.0.0 Release。
- 下载
md2wechat-publisher-2.0.0.zip，不要下载 GitHub 自动生成的 Source code。 - 解压，把
md2wechat-publisher文件夹放到笔记库.obsidian/plugins/下。 - 确认相对路径为
.obsidian/plugins/md2wechat-publisher/main.js，不要多套一层目录。 - 重启 Obsidian，在“设置 → 第三方插件”中启用 MD2WeChat Publisher。
当前提供手动安装包，插件市场审核后续另行提交。安装方式以仓库 README为准。
第一次预览
- 打开一篇自己的 Markdown 文章。
- 打开“公众号排版”面板，点击“先预览当前文章”。
- 检查标题、正文、代码和图片，按需要搜索并选择主题。
- 字号和复制排版位于“更多”菜单。
- 修改原文后点击“刷新排版”，沿用当前主题与字号，读取最新原文。
插件排版流程不会覆盖原文。刷新用于更新排版；希望继续润色或重组内容时，可另行交给自己的 Agent，并检查其修改。
先完成这一步，再配置公众号草稿流程。只需要复制排版时，可以在此停止。
确认创建草稿
- 点击面板顶部“创建草稿”。
- 选择目标公众号和封面。
- 核对标题、作者、摘要和正文。
- 最后确认，才执行图片上传与草稿创建。
- 创建成功后，弹框关闭，面板保留查看入口。再到公众号后台核对结果。
按文章保留的本地记录会显示公众号、创建时间和当前版本是否已经创建。插件会阻止同一次请求重复创建。
刷新排版不会更新微信后台旧草稿。“创建新版草稿”会新增一篇，并再次要求确认。插件不会自动正式发布；后台修改也不会反向同步。
如果结果不确定，先检查公众号草稿箱，不要盲目重试。本地成功记录不保证后台草稿仍然存在。
接入自己的 Agent
手动预览和创建草稿不依赖 Obsidian 官方命令行。希望 Agent 操作当前笔记时，再完成以下步骤：
- 确认 Obsidian 和安装程序均支持官方命令行，并启用该功能。
- 将安装包中的
skills/obsidian-md2wechat安装到所用 Agent 的技能目录。 - 保留 md2wechat 自带技能。
- 多个笔记库同时打开时，明确告诉 Agent 使用哪一个。
准备完成后，可以这样表达任务：
排版 Obsidian 当前文章，完成后展示给我。
先让我查看排版，不创建公众号草稿。
插件不预选或绑定某个 Agent。具备本地命令执行、文件读写和技能支持的工具可按通用约定接入，但独立宿主尚未逐个完成验收。接入说明不是所有宿主均已验证的承诺。
旧版升级
2.0 改为复用主 CLI 的配置和执行能力，不再使用插件内旧接口配置。旧设置保留用于回退，但不会自动迁移密钥。
升级前备份原插件目录与设置，按安装与升级说明确认目录和配置。先校验主 CLI，再安装 2.0；不要把“旧版能用”当作新版 CLI 已配置完成。
遇到问题怎么排查
| 现象 | 下一步 |
|---|---|
| 找不到 md2wechat | 在终端检查安装与 md2wechat version --json |
| 排版服务认证失败 | 执行配置校验，检查排版 Key 与当前服务范围 |
| 插件没有出现 | 检查 ZIP 解压层级、插件目录和 Obsidian 版本 |
| 修改原文后预览没变化 | 点击刷新排版，确认当前打开的是目标文章 |
| Agent 无法操作当前笔记 | 核对官方命令行、技能目录与目标笔记库 |
| 草稿无法创建 | 检查目标账号、凭证、封面及公众号白名单要求 |
| 创建结果未知 | 先检查后台草稿箱，不要直接重试 |
需要开通服务时，使用Obsidian 接入咨询。反馈故障请提供系统、Obsidian、插件与 CLI 版本、复现步骤和脱敏截图；不要发送密钥。