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

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

快速使用

依赖安装

bash

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

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

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

格式转换（单篇）

bash

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`	批量转换：指定目录路径	-

批量转换（整个目录）

bash

# 转换目录下所有 .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

一键发布 - 配置（首次）

bash

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

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

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

一键发布（单篇）

bash

# 创建草稿（推荐，可在公众号后台检查后手动发布）
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

批量发布（整个目录）

bash

# 批量创建草稿
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`

使用流程

方式一：预览 + 手动粘贴

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

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

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

方式三：API 一键发布

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

可用主题

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

支持的 Markdown 元素

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

注意事项

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