Markdown 转微信公众号格式 & 一键发布

将 Markdown 文章转换为微信公众号编辑器可直接粘贴的富文本 HTML，排版美观大方，代码高亮、表格、目录等元素均正确渲染。支持通过 API 一键创建草稿/发布到微信公众号。

快速使用

依赖安装

# 格式转换依赖
pip install markdown pygments beautifulsoup4

# 一键发布依赖（可选，仅发布时需要）
pip install requests

# 更好的默认封面图（可选）
pip install Pillow

格式转换（单篇）

python ~/.cursor/skills/md-to-wechat/scripts/convert.py input.md

参数说明：

参数	说明	默认值
input.md	输入的 Markdown 文件路径	必填
-o output.html	输出 HTML 文件路径	{input}_wechat.html
--theme	主题风格：blue / green / dark / warm	blue
--dir	批量转换：指定目录路径	-

批量转换（整个目录）

# 转换目录下所有 .md 文件
python ~/.cursor/skills/md-to-wechat/scripts/convert.py --dir ./articles

# 批量转换，指定主题
python ~/.cursor/skills/md-to-wechat/scripts/convert.py --dir ./articles --theme green

一键发布 - 配置（首次）

# 首次使用：配置 AppID 和 AppSecret
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --setup

需要在微信公众平台获取：

1. 进入 公众号后台 → 设置与开发 → 基本配置
2. 获取 AppID 和 AppSecret
3. 将本机 IP 添加到 IP 白名单

一键发布（单篇）

# 创建草稿（推荐，可在公众号后台检查后手动发布）
python ~/.cursor/skills/md-to-wechat/scripts/publish.py input.md

# 创建草稿并直接发布
python ~/.cursor/skills/md-to-wechat/scripts/publish.py input.md --publish

# 指定标题、作者和封面图
python ~/.cursor/skills/md-to-wechat/scripts/publish.py input.md --title "文章标题" --author "作者" --thumb cover.jpg

批量发布（整个目录）

# 批量创建草稿
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --dir ./articles

# 批量创建草稿并发布
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --dir ./articles --publish

# 批量操作，自定义间隔（默认60s）
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --dir ./articles --delay 30

发布参数说明：

参数	说明	默认值
--setup	配置 AppID/AppSecret	-
--publish	创建草稿后直接发布	否（仅创建草稿）
--title	文章标题	自动从 h1 提取
--author	文章作者	空
--thumb	封面图片路径（建议 900x500+）	自动生成默认封面
--theme	文章主题风格	blue
--dir	批量操作：指定目录路径	-
--delay	每篇文章操作间隔秒数（防限流）	60

使用流程

方式一：预览 + 手动粘贴

1. 执行转换命令，生成 HTML 文件
2. 用浏览器打开生成的 HTML 文件
3. 点击页面顶部「复制内容到剪贴板」按钮
4. 在微信公众号后台编辑器中 Ctrl+V 粘贴即可

方式二：API 一键创建草稿（推荐）

1. 首次使用先运行 --setup 配置凭据
2. 执行发布命令，脚本自动创建草稿
3. 前往公众号后台检查草稿内容，确认后手动群发

方式三：API 一键发布

1. 首次使用先运行 --setup 配置凭据
2. 执行 --publish 命令，脚本自动创建草稿并发布
3. 注意：API 发布的文章不会推送给粉丝，如需推送请在后台手动群发

可用主题

• blue (优雅蓝)：蓝色系，专业简洁，适合技术/商务文章
• green (清新绿)：绿色系，自然清新，适合生活/科普文章
• dark (经典黑)：黑色系，沉稳大气，适合深度/学术文章
• warm (温暖橙)：橙色系，活泼温暖，适合营销/故事文章

支持的 Markdown 元素

• 标题 (h1-h4)，带装饰样式
• 段落，两端对齐
• 加粗、斜体、删除线
• 有序/无序列表，含嵌套
• 代码块（带语法高亮和语言标签）
• 行内代码
• 表格（带斑马纹）
• 引用块
• 分割线
• 图片（居中自适应，自动上传到微信素材库）
• 脚注
• 任务列表

注意事项

• 微信编辑器不支持外部链接跳转，链接会显示为带下划线的文字
• 一键发布时，文章内的外部图片会自动上传到微信素材库
• 手动粘贴模式下，图片需要先上传到微信素材库
• 所有样式均为内联 CSS，确保在微信编辑器中完整保留
• 代码块在移动端会自动横向滚动
• 首次发布需要配置 AppID/AppSecret 并将 IP 加入白名单
• access_token 有效期 2 小时，脚本会自动缓存和刷新
• 通过 API 发布的文章不会出现在粉丝的订阅消息中，需手动群发
• 2025年7月起，个人主体/未认证账号将被回收发布接口权限