简诗 Markdown 转微信 HTML
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装规范名 @user_fccf428b/markdown-to-wechat-html-formatter。
技能介绍
为什么需要它
微信公众号的编辑器不接受普通 HTML 粘贴,你把一篇渲染好的 Markdown 直接丢进去,样式会丢得干干净净:标题没有层级感、代码块没有高亮、表格挤成一团、引用块缩进丢失。结果要么在微信后台手动调样式,要么写一堆 <section> 和 <span style> 标签,改一次排版重来一次。
它做了什么
这个技能把一篇 Markdown 文章转换成内联 CSS 的 HTML,输出文件与源 Markdown 同目录同名,可直接粘贴进微信公众平台后台。
转换前有一个中文内容预检:如果输入包含 CJK 字符,技能会建议先用 baoyu-format-markdown 修一遍——主要解决粗体标记包含标点导致的 ** 解析失败,以及中英文之间缺失的空格。这一步可选,用户拒绝则继续原文件。
主题解析按优先级走:用户显式指定 → 本技能 EXTEND.md 里的 default_theme → baoyu-post-to-wechat 技能的 EXTEND.md 回退 → 都找不到才弹窗询问。配色预设覆盖 13 种,从 #0F4C81 经典蓝到 #D97757 暖橙。
Mermaid 图表会被渲染成 PNG 内嵌,可调主题、缩放(≤4 倍)、显示宽度(默认 860px)和背景色。--cite 开启后,普通外链变成上标数字并在文末汇总成「引用链接」区块,mp.weixin.qq.com 链接保持原样。
适用边界
- 输出是单文件 HTML、样式全部内联,不依赖外部 CSS 或 CDN,因为微信编辑器会剥离外链样式。
- 配置通过
EXTEND.md加载,支持项目级、XDG 目录、用户主目录三个位置,第一个找到的生效。 - 运行依赖 Bun,没有则用
npx -y bun兜底。 - 涉及发布、删除等外部写入操作时,技能先展示目标和影响,等用户确认才执行。
使用场景
- 技术博客作者写好含代码块、表格、引用块的 Markdown 长文,需要转成内联样式的 HTML 粘贴进公众号后台发布
- 文章里带有 Mermaid 架构图和流程图,需要技能渲染成 PNG 内嵌进 HTML,保证图在微信里正常显示
- 推文引用了多个外部链接,开启 --cite 把外链转成上标编号和文末引用区,避免读者在微信里打不开外链
- 团队想统一公众号文章的主色、字体和标题层级,通过 EXTEND.md 写默认主题,之后转换时无需重复设置
适合人员
- 技术博客作者,写完 Markdown 想同步发到公众号,不想在后台逐段手动调样式
- 公众号运营编辑,每天处理多篇外部作者投来的 Markdown 稿件,需要统一排版风格
- 文档工程师,技术文档中大量使用 Mermaid 图,需要把图表连同正文一起嵌入公众号推文
- 用 AI Agent 批量处理文章转换的工程师,需要命令行选项和 JSON 输出接入自动化流程