企业官网建设流程全解析

md2wechat-skill 命令行完全指南：convert、humanize 等核心命令使用技巧

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

md2wechat-skill 是一款高效的 Markdown 转微信公众号 CLI 工具，支持 40+ 排版样式和专业主题、AI 配图、批量发布及多账号管理，让微信公众号内容创作与发布更简单。

一、快速安装与基础配置

1.1 一键安装步骤

通过以下命令快速安装 md2wechat-skill：

git clone https://gitcode.com/gh_mirrors/md/md2wechat-skill cd md2wechat-skill make install

1.2 配置文件设置

首次使用需配置微信公众号相关信息，配置文件路径为 docs/examples/config.yaml.example，复制该文件并修改为config.yaml，填写公众号 AppID、AppSecret 等信息。

二、核心命令详解

2.1 convert：Markdown 转微信排版

convert命令是 md2wechat-skill 的核心功能，可将 Markdown 文件转换为微信公众号兼容的排版格式。

基本用法：

md2wechat convert -i article.md -o output.html

图：Markdown 到微信公众号排版的转换过程

该命令支持多种主题，如默认主题、字节跳动主题等，可通过-t参数指定：

md2wechat convert -i article.md -o output.html -t bytedance

主题文件位于 themes/ 目录，包含多种预设样式，如 themes/default.yaml、themes/bytedance.yaml 等。

2.2 humanize：AI 优化文本表达

humanize命令利用 AI 技术优化文章内容，使其更符合微信公众号的阅读习惯，提升文章吸引力。

使用方法：

md2wechat humanize -i article.md -o humanized_article.md

可通过--style参数选择不同的文风，如专业、轻松、幽默等，预设样式定义在 internal/assets/builtin/prompts/humanizer/ 目录下。

2.3 generate-image：AI 配图生成

generate-image命令可根据文章内容自动生成相关配图，提升文章视觉效果。

基本命令：

md2wechat generate-image -i article.md -o images/

支持多种图片风格，如插画、数据可视化等，图片生成配置可参考 internal/image/ 目录下的相关源码。

三、高级功能与实用技巧

3.1 批量处理与多账号管理

md2wechat-skill 支持批量转换和发布多篇文章，同时可管理多个微信公众号账号。通过配置文件中的账号列表，使用-a参数指定发布账号：

md2wechat convert -i ./articles/*.md -o ./output/ -a account1

3.2 主题定制与样式扩展

用户可自定义主题样式，主题文件格式参考 themes/custom.yaml，通过修改颜色、字体、布局等参数，打造个性化的公众号排版。

图：默认主题排版效果展示

四、常见问题与解决方法

4.1 转换后格式错乱

若转换后的文章格式错乱，可检查 Markdown 语法是否规范，或尝试使用doctor命令诊断问题：

md2wechat doctor -i article.md

4.2 AI 配图生成失败

确保已正确配置 AI 服务 API 密钥，相关配置位于 config.yaml 中的image_provider部分，API 密钥验证逻辑可查看 internal/apikey/validator.go。

五、总结

md2wechat-skill 提供了从 Markdown 到微信公众号的完整解决方案，通过convert、humanize、generate-image等核心命令，结合丰富的主题和 AI 功能，让公众号内容创作更高效、更专业。更多详细用法可参考官方文档 docs/USAGE.md。

希望本指南能帮助你快速掌握 md2wechat-skill 的使用技巧，提升微信公众号运营效率！ 🚀

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