用途
该技能用于将 Markdown 文章转换为微信公众号(微信公众号)兼容的 HTML 格式,生成带主题样式和内联 CSS 的 HTML,便于粘贴到微信公众号编辑器中。触发场景包括:把 Markdown 转成微信格式、请求“转换为微信公众号格式”“生成微信文章”“公众号排版”,以及为文章套用微信样式。
主要能力
- 将标准 Markdown 转换为微信公众号兼容的 HTML,并应用专业样式。
- 提供四种主题:
- default(专业蓝色):主色 #1e6bb8,适合技术文章、教程、通用内容。
- orange(活力橙):主色 #e67e22,适合运动、美食、娱乐、促销活动。
- grid(格子主题):带序号徽章、旋转动画、自动列表嵌套;支持清新绿(green,#52c41a)、大气蓝(blue,#007AFF)、活力橙(orange,#e67e22)三种配色,格子线颜色随所选配色变化。
- aurora(极光靛紫):主色 #6c5ce7,适合 AI 前沿、产品发布、创新趋势类内容。
- 可选指定微信文章标题(--title)与是否包含微信头部/底部(--no-header-footer)。
- 支持 --preview,自动打开浏览器预览页面,提供“复制 HTML 代码”按钮及粘贴到微信编辑器的说明。
使用方式
- 识别用户请求:当用户要求 Markdown 转微信格式、生成微信文章、公众号排版或套用微信样式时触发。
- 收集信息:需要输入 Markdown 文件路径(来自用户请求或当前目录)。除非用户已明确指定主题,否则通过 AskUserQuestion 工具交互展示四种主题供选择;若选择 grid,再询问配色(green/blue/orange)。按需询问文章标题、是否包含微信头部/底部。
- 执行转换:始终使用技能脚本的绝对路径,并在 Python 虚拟环境(venv)中运行:
python3 <skill-path>/haizei-wechat-article-convert/scripts/md_to_wechat.py <input.md> [output.html] [options]
推荐始终使用 --preview 打开浏览器复制按钮:
python3 <skill-path>/haizei-wechat-article-convert/scripts/md_to_wechat.py input.md --theme <selected-theme> --preview
带标题与浏览器预览:
python3 <skill-path>/haizei-wechat-article-convert/scripts/md_to_wechat.py input.md --theme <theme> --title "<article-title>" --preview
仅内容(无微信元素)并预览:
python3 <skill-path>/haizei-wechat-article-convert/scripts/md_to_wechat.py input.md --theme <theme> --no-header-footer --preview
- 呈现结果:确认转换成功、展示所用主题、输出文件位置,显示生成 HTML 的前约 30 行,并提醒用户可将 HTML 复制粘贴到微信编辑器。
依赖与运行环境
脚本依赖:markdown>=3.5.0(Markdown 解析)、beautifulsoup4>=4.12.0(HTML 处理)、pygments>=2.16.0(代码语法高亮)。务必在 Python 虚拟环境(venv)中运行脚本,不要将依赖安装到系统 Python。首次设置虚拟环境:
cd <skill-path>/haizei-wechat-article-convert/scripts python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt
在虚拟环境中运行脚本:
.venv/bin/python md_to_wechat.py input.md --theme <theme> --preview
若 venv 不存在,需先创建再运行;若 venv 内缺少依赖,可安装:
<skill-path>/haizei-wechat-article-convert/scripts/.venv/bin/pip install -r <skill-path>/haizei-wechat-article-convert/scripts/requirements.txt
适用场景
适用于需要把 Markdown 内容排版发布到微信公众号的场景,例如技术文章、教程、通用内容(default);运动、美食、娱乐、促销(orange);需要序号徽章与动画效果、并可按主题挑选配色的内容(grid);AI 前沿、产品发布、创新趋势类内容(aurora)。
限制与注意事项
- 需在 Python 虚拟环境中运行脚本,并事先安装 markdown、beautifulsoup4、pygments 依赖。
- 若依赖缺失、脚本路径错误或未复制完整含内联样式的 HTML,可能导致转换或样式显示异常;对应处理方式分别为安装依赖、使用绝对路径、确保复制完整 HTML 内容。
- 关于收费、价格、平台范围、效果保证等信息,资料暂未提供。
资源
- scripts/md_to_wechat.py:主转换脚本。
- references/themes.md:主题详细说明。
- assets/examples/sample.md:示例文章,用于测试或展示功能。