WorkBuddy 实战：一篇 Markdown 稿件，90 分钟压缩到 7 分钟直发公众号草稿箱 | 社区贡献

内容创作来源：腾讯云开发者社区 · 2026-09-09 · 原文：https://cloud.tencent.com/developer/article/2739586

作者：行者全栈架构师 · 发布于 2026-09-09

概述

微信公众号技术文章的发布链路——从 Markdown 排版到图片上传、再到推送草稿箱，通常一篇要 90 分钟。本文记录如何用 WorkBuddy 把这条链路沉淀成可复用技能 wechat-mp-publisher：首次约 40 分钟跑通技能创建、示例稿件和凭据配置，之后每篇只要 7 分钟。全程 19 张实操截图、3 个真实踩坑，最终产出是后台草稿箱里可验收的一篇文章。

难度： 中级 | 适用读者： 内容运营、新媒体从业者、个人公众号运营者、AI 办公工具评估者

环境： WorkBuddy 桌面端 5.5.3（2026-09），微信公众号（已认证订阅号）

行业领域： 内容运营/新媒体 | 使用模式： 云端助理（自定义技能）

1. 场景开篇

2026 年 9 月 8 日，22:05，我坐在家里电脑前。

我运营着一个技术公众号「行者架构谈」，文章都是本地 Markdown 写的。写是快，但每次发稿都要经历一遍发布链路：Markdown 贴进公众号编辑器重新排版，代码块没有语法高亮，只能复制成纯文本；表格一长就错位，要手动调；引用、列表、图注一个个手工处理。一篇 4000 字带 8 个代码块的文章，上次我花了 1 个半小时，其中排版就占 40 多分钟。

排版完还有图片环节：2 张正文图加 1 张封面图，全部手动上传、手动插入。封面还得先裁成 2.35:1。预览发现代码块溢出，重新来，而且这次排出来的效果和上次不完全一样。

我决定把这条链路沉淀成 WorkBuddy 技能，名字就叫 wechat-mp-publisher。

2. 技能设计思路

输入

Markdown 源文件路径
图片目录路径（可选）
公众号凭据（AppID + AppSecret）

处理流程

读取 Markdown 文件
转换为符合公众号规范的 HTML
代码块添加语法高亮
处理图片（上传到图床或本地路径）
生成封面图（2.35:1 比例）
调用公众号 API 推送到草稿箱

输出

草稿箱文章 ID
预览链接（可选）

3. 技能创建过程

3.1 创建技能骨架

在 WorkBuddy 中创建新技能，结构如下：

wechat-mp-publisher/
├── SKILL.md          # 技能描述文件
├── scripts/
│   └── publish.py    # 主处理脚本
└── references/
    └── template.html # HTML 模板

3.2 SKILL.md 配置

## 触发条件
用户提到"发布公众号"、"推送草稿箱"、"排版文章"时触发

## 功能描述
将 Markdown 稿件转换为公众号 HTML，推送到指定公众号草稿箱

## 使用方法
1. 用户提供 Markdown 文件路径
2. 用户提供公众号 AppID 和 AppSecret（首次需配置）
3. 技能自动完成排版、图片处理、推送全流程

3.3 核心脚本逻辑

# publish.py 核心逻辑
def publish_markdown_to_wechat(md_path, appid, secret):
    # 1. 读取 Markdown
    md_content = read_markdown(md_path)

    # 2. 转换为 HTML（保留代码高亮）
    html_content = markdown_to_html(md_content)

    # 3. 处理图片
    html_with_images = process_images(html_content, image_dir)

    # 4. 调用公众号 API
    access_token = get_access_token(appid, secret)
    result = push_to_draft(access_token, html_with_images)

    return result

4. 实际效果对比

环节	手动操作	使用技能后
排版	40 分钟	自动处理
图片上传	15 分钟	自动处理
封面制作	10 分钟	自动生成
API 调用	手动复制粘贴	自动推送
总计	约 90 分钟	约 7 分钟

首次跑通约 40 分钟（包含技能创建、调试、凭据配置），之后每篇只需 7 分钟。

5. 3 个真实踩坑

坑 1：代码块高亮丢失

现象： 转换后的 HTML 中，代码块没有语法高亮，显示为纯文本。 原因： 默认 Markdown 转换器不支持代码高亮。 解决： 使用 highlight.js 或手动添加 <pre><code class="language-python"> 标签。

坑 2：图片路径问题

现象： 图片在本地能显示，推送到公众号后变红叉。 原因： 公众号只支持 HTTPS 图片 URL，本地路径无法直接使用。 解决： 上传图片到图床（如腾讯云 COS），替换 Markdown 中的本地路径。

坑 3：封面图尺寸不对

现象： 封面图比例不符合公众号要求（2.35:1），被裁剪。 原因： 原始图片尺寸不匹配。 解决： 在脚本中自动裁剪图片到 900x383 像素（2.35:1 比例）。

6. 使用示例

首次使用（配置阶段）

用户：帮我配置 wechat-mp-publisher 技能
AI：请提供公众号 AppID 和 AppSecret，我将帮你完成凭据配置
用户：AppID: wx1234567890, AppSecret: abcdef123456
AI：凭据已保存，技能配置完成

日常发布

用户：发布 D:\Articles\2026-09-09.md
AI：正在处理...
  - 读取 Markdown...
  - 转换 HTML...
  - 处理图片...
  - 生成封面...
  - 推送到草稿箱...
  - 完成！文章 ID: xxxxx

7. 后续优化方向

多平台适配：支持知乎、CSDN、掘金等平台的一键发布
模板库：提供多种排版模板，用户可按需选择
定时发布：结合 WorkBuddy 自动化任务，设置定时推送
数据统计：发布后自动抓取阅读数、点赞数等数据

8. 总结

通过 WorkBuddy 技能化，把重复的发布链路固化下来，首次投入约 40 分钟，后续每篇节省约 80 分钟。对于频繁发布技术文章的运营者来说，ROI 非常高。

核心经验： - 技能设计要自包含，所有必要参数都要在 Prompt 中明确 - 图片处理要提前规划，避免临时抱佛脚 - 首次跑通后立即保存为模板，方便后续复用

← 返回社区贡献