$npx -y skills add zhylq/yuan-skills --skill zhy-markdown2wechatUse when converting Markdown into WeChat-compatible inline HTML with theme styles for preview, copy-paste, or downstream draft publishing.
| 1 | ## 概述 |
| 2 | 这是一个用于将标准的 Markdown 文本,转换成能够直接复制粘贴给微信公众号文章编辑器的 HTML 文件的 Skill。微信公众号的 HTML 结构要求所有样式必须是内联的(Inline CSS)。 |
| 3 | |
| 4 | 此 Skill 的核心优势是 **零部署**。只要用户的环境中安装了 Node.js,即可通过执行本 Skill 自带的转换脚本极其轻量地完成转换任务,它会自动在临时目录加载所需依赖并在完成后清理,不留任何环境垃圾,无需用户预先执行 `npm install`。 |
| 5 | |
| 6 | ## 适用场景 |
| 7 | 当用户希望你: |
| 8 | - 把 md、markdown 格式的文件转为微信公众号文章。 |
| 9 | - 根据 Markdown 生成带 CSS 样式的公众号排版 HTML。 |
| 10 | |
| 11 | ## 详细执行步骤 |
| 12 | 当你收到用户的转换请求时,如果不指定主题,默认使用 `resources/themes/default.css`。 |
| 13 | |
| 14 | 请你**直接**代用户执行以下命令,调用本 Skill 自带的 `scripts/convert.js`。如果你在使用工具(例如 Terminal / run_command),请直接调用即可。 |
| 15 | |
| 16 | ### 执行转换脚本 |
| 17 | 使用 `node` 执行转换: |
| 18 | ```bash |
| 19 | node <当前skill路径>/scripts/convert.js <用户指定的markdown文件> <选择的主题css文件> <输出目标html文件路径> |
| 20 | ``` |
| 21 | |
| 22 | *(例如将 `input.md` 转换为带默认主题的 `output.html`:`node wechat-markdown-skill/scripts/convert.js input.md wechat-markdown-skill/resources/themes/default.css output.html`)* |
| 23 | |
| 24 | 脚本将会自动安全地处理 Markdown 转换、增加 `<section id="MdWechat">` 微信容器、内联注入指定的 CSS 主题。 |
| 25 | |
| 26 | 注意:当前主题体系会在容器根节点中携带 CSS 变量(如 `--text-color`),以便多主题共享配色语义。若后续要通过 `zhy-wechat-publish` 上传到草稿箱,应使用其最新发布脚本,它会在上传前自动展开 `var(--xxx)`,避免微信后台丢失颜色样式。 |
| 27 | |
| 28 | ### 交付输出结果 |
| 29 | 完成后,直接告诉用户:"您的公众号 HTML 已生成在 `[目标文件]` 中,可直接在浏览器打开预览效果,或用编辑器/浏览器打开后全选复制,粘贴到微信公众号后台即可。" |
| 30 | |
| 31 | ## 主题支持 (Themes) |
| 32 | 本目录下的 `resources/themes/` 可以存放多套不同的 CSS 主题方案。 |
| 33 | 如果用户要求更换主题风格,你可以查看并读取该目录下存在的 CSS 文件路径并传递给脚本,这使得该 Skill 天然支持“换肤”功能。 |