Wechat formatter

Skill YiShu5/claude-skills/skills/wechat-formatter

Battle-tested coding-agent skills for product, content, writing, presentations, and workflow automation.

Install

npx -y skills add YiShu5/claude-skills --skill wechat-formatter

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

把 Markdown 文稿转换成微信公众号可用的内联样式 HTML。**触发场景**:用户说 "把 markdown 转成公众号能用的 HTML" / "排版一下这篇文章" / "套个主题" / "微信编辑器不识别我的样式" / 任何提到「公众号排版 / 微信 HTML / md 转 html / doocs 主题」的请求。微信编辑器不识别 `<style>` 标签,必须把所有 CSS 内联到每个 HTML 元素的 style 属性里——本 skill 用 doocs/md 主题完成这件事。本 skill 只负责格式转换;写作交给 wechat-writer,发布交给 wechat-publisher。

SKILL.md

3.2 KB, as published. Nobody here has run it

wechat-formatter · Markdown → 微信 HTML

只解决一件事:把 Markdown 转成微信编辑器粘贴后样式不丢的 HTML。

核心问题

微信公众号编辑器不识别 <style> 标签和 CSS class。所以普通的 markdown → html 转换器输出的 HTML 粘到微信里会变成裸文本,所有样式全丢。

唯一可靠方案:所有 CSS 都内联到元素的 style="..." 属性里。doocs/md 是这件事的开源标准,本 skill 直接调用它。

使用方法

python3 scripts/markdown_to_wechat_doocs.py \
  --input drafts/article.md \
  --output drafts/article.html \
  --theme <主题名>

输出的 HTML 可以直接复制粘贴到微信公众号编辑器,样式全部保留。

主题选择

8 个主题,按文章内容氛围选(不只看标题关键词):

文章基调	推荐主题	适用
温暖、励志、有人情味	`orange`	个人成长 / 励志 / 鸡汤 / 故事
专业、理性、技术感	`blue`	技术评测 / 工具教程 / 商业分析
清新、自然、放松	`green`	健康养生 / 户外 / 环保
文艺、清爽、小清新	`cyan`	文艺随笔 / 旅行 / 生活美学
优雅、高端、品牌	`purple`	品牌故事 / 艺术文化 / 设计
简约、高级、极简	`black`	摄影 / 极简主题 / 严肃话题
热情、节日、醒目	`red`	节日 / 重要通知 / 活动
甜美、浪漫、少女	`pink`	情感 / 美妆 / 少女向

选择原则:读完 Markdown 后,问自己"这篇要给读者什么情绪",再选主题。不要靠标题关键词匹配(比如标题里没"励志"也可能是励志文)。

如果用户已在 .env 设了 MARKDOWN_THEME:除非用户明确说"换个主题",否则用 .env 里的。

输出验收

转出来的 HTML 必须:

不包含 <style> 标签(所有样式必须内联)
不包含 CSS class(微信不解析)
图片如果是本地路径 → 必须先用 wechat-publisher 的 upload_material.py 换成微信 URL,否则发布后图片裂掉

不做的事

不发布到草稿箱 → 用 wechat-publisher
不写文章 / 不改稿 → 用 wechat-writer
不生成封面图 → 用 wechat-publisher 的 generate_cover.py
不上传本地图片到微信 CDN → 用 wechat-publisher 的 upload_material.py(如果 Markdown 里有 ![](./local/img.png),先告诉用户调用 publisher 上传换链接,再回来排版)

配置

.env 文件支持的变量:

MARKDOWN_THEME=        # orange / blue / green / purple / red / cyan / black / pink
                       # 留空则让 agent 按内容判断