SuperAPI AI 工具集

haizei-wechat-article-convert

办公与效率

查看项目

更新于 10-16 10:16

技能介绍

用途

该技能用于将 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 代码”按钮及粘贴到微信编辑器的说明。

使用方式

  1. 识别用户请求:当用户要求 Markdown 转微信格式、生成微信文章、公众号排版或套用微信样式时触发。
  2. 收集信息:需要输入 Markdown 文件路径(来自用户请求或当前目录)。除非用户已明确指定主题,否则通过 AskUserQuestion 工具交互展示四种主题供选择;若选择 grid,再询问配色(green/blue/orange)。按需询问文章标题、是否包含微信头部/底部。
  3. 执行转换:始终使用技能脚本的绝对路径,并在 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

  1. 呈现结果:确认转换成功、展示所用主题、输出文件位置,显示生成 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:示例文章,用于测试或展示功能。