md2wechat-skill 环境配置完全指南：从安装到使用的一站式教程

md2wechat-skill 环境配置完全指南：从安装到使用的一站式教程

【免费下载链接】md2wechat-skillMarkdown to WeChat CLI | 一键排版发布到微信公众号：支持 40+ 排版样式和专业主题 、AI 配图 、批量发布 、多账号管理项目地址: https://gitcode.com/gh_mirrors/md/md2wechat-skill

md2wechat-skill 是一款功能强大的 Markdown 转微信公众号排版工具，支持 40+ 排版样式和专业主题、AI 配图、批量发布及多账号管理，能帮助用户快速将 Markdown 文档转换为微信公众号格式并发布。

快速了解 md2wechat-skill

md2wechat-skill 作为 Markdown to WeChat CLI 工具，致力于为用户提供便捷高效的微信公众号排版发布解决方案。它能够一键排版 Markdown 文档并发布到微信公众号，大大简化了公众号运营者的工作流程。

核心功能亮点

• 丰富排版样式：拥有 40+ 种排版样式，满足不同文章类型的排版需求。
• 专业主题：提供多种专业主题，可根据文章风格选择合适的主题。
• AI 配图：集成 AI 配图功能，自动为文章生成合适的图片。
• 批量发布：支持批量处理和发布多篇文章，提高工作效率。
• 多账号管理：可同时管理多个微信公众号账号，方便运营多个平台。

多种安装方式，选择最适合你的

方式一：npm 安装（推荐新手）

npm 安装是最简单快捷的方式，适合大多数新手用户。只需在命令行中执行以下命令：

npm install -g @geekjourneyx/md2wechat

如果安装过程中提示npmmirrortarball404，可以尝试指定 npm 官方 registry：

npm install -g @geekjourneyx/md2wechat --registry=https://registry.npmjs.org/

方式二：Homebrew 安装（Mac 用户首选）

对于 Mac 用户，使用 Homebrew 安装更加方便，执行以下命令即可：

brew install geekjourneyx/tap/md2wechat

这种方式会直接下载当前版本对应平台的预编译归档并安装md2wechat，只安装 CLI 本身，不会运行远程 installer。

方式三：Go install（已有 Go 环境时可选）

如果你已经有稳定可用的 Go 环境，可以使用 Go install 方式：

go install github.com/geekjourneyx/md2wechat-skill/cmd/md2wechat@v2.10.0

方式四：脚本安装（通用方式）

如果以上两种方式都不适合你，可以使用固定版本的脚本安装：

curl -fsSL https://github.com/geekjourneyx/md2wechat-skill/releases/download/v2.10.0/install.sh | bash

如果是通过 install.sh 安装的，可能需要执行以下命令将路径添加到环境变量：

export PATH="$HOME/.local/bin:$PATH"

配置微信公众号凭证，轻松对接

初始化配置文件

安装完成后，需要初始化配置文件，执行以下命令：

md2wechat config init

该命令会生成配置文件，你可以根据需要指定配置文件路径，如：

md2wechat config init ./md2wechat.yaml

填写微信公众号 AppID 和 Secret

在生成的配置文件中，找到wechat部分，填写你的微信公众号 AppID 和 Secret：

wechat: appid: "你的微信公众号 AppID" secret: "你的微信公众号 Secret"

如果需要管理多个公众号账号，可以在配置文件中添加多个账号信息：

wechat: accounts: - name: "main" appid: "主公众号 AppID" secret: "主公众号 Secret" - name: "client-a" appid: "客户 A AppID" secret: "客户 A AppSecret"

简单三步，完成 Markdown 转微信公众号文章

第一步：本地预览文章效果

在转换和发布之前，建议先进行本地预览，查看文章效果。使用以下命令：

md2wechat preview article.md

也可以指定输出路径：

md2wechat preview article.md --output /path/to/preview.html

preview命令会生成本地 HTML 预览文件，不上传、不创建草稿，方便你在本地确认文章排版效果。

第二步：转换 Markdown 为微信 HTML

确认预览效果无误后，就可以将 Markdown 转换为微信公众号格式的 HTML 了。基本转换命令如下：

md2wechat convert article.md --output output.html

如果需要使用特定主题，可以通过--theme参数指定，如：

md2wechat convert article.md --theme bytedance --output output.html md2wechat convert article.md --theme minimal-blue --output output.html

md2wechat-skill 提供了多种专业主题，如 bytedance、apple、sports、chinese、cyber 等，你可以根据文章风格选择合适的主题。

第三步：创建微信公众号草稿

转换完成后，可以直接创建微信公众号草稿，命令如下：

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

如果需要指定公众号账号，可以使用--wechat-account参数：

md2wechat convert article.md --draft --cover cover.jpg --wechat-account client-a

也可以使用已有的微信永久封面资产，通过--cover-media-id参数指定：

md2wechat convert article.md --draft --cover-media-id PERMANENT_MEDIA_ID

常见问题解决，让使用更顺畅

提示command not found: md2wechat

如果安装后执行命令提示command not found: md2wechat，可以先检查是否安装成功，执行以下命令：

command -v md2wechat

如果没有输出，说明系统找不到二进制文件，可能是安装路径没有添加到环境变量中。对于通过 install.sh 安装的用户，可以执行：

export PATH="$HOME/.local/bin:$PATH"

convert命令返回 API key 等错误

如果convert命令返回 API key、base URL、网络或远程 API 错误，可能是配置文件中的相关参数设置不正确，或者网络连接存在问题。请检查配置文件中的 API 相关设置，并确保网络连接正常。

preview --mode ai不给最终视觉稿

因为当前 AI 模式返回的是 prompt / request，不是最终 HTML。为了避免误导，preview --mode ai会明确降级成确认页，而不是伪造一个“看起来像最终结果”的假稿。

总结

通过本指南，你已经了解了 md2wechat-skill 的安装方法、配置步骤以及基本使用流程。从安装到发布，只需简单几步，就能快速将 Markdown 文档转换为精美的微信公众号文章。赶快尝试使用 md2wechat-skill，提升你的公众号运营效率吧！

官方文档：docs/USAGE.md 配置指南：docs/CONFIG.md

【免费下载链接】md2wechat-skillMarkdown to WeChat CLI | 一键排版发布到微信公众号：支持 40+ 排版样式和专业主题 、AI 配图 、批量发布 、多账号管理项目地址: https://gitcode.com/gh_mirrors/md/md2wechat-skill