md2WeChat-python

将 Markdown 文件转换为微信公众号兼容的内联样式 HTML，并一键发送到微信草稿箱。支持 Front Matter 元数据、表格、代码块、列表、图片自动上传等完整排版能力。

Security Scan

The skill's code, runtime instructions, and requested credentials are coherent with its stated purpose (convert Markdown to WeChat-compatible HTML and optionally upload to a WeChat draft); nothing in the package indicates unexplained or disproportionate access.

Purpose & Capability

Name/description match the code and runtime instructions: scripts convert Markdown to inline-styled HTML and the wechat_client module uploads images and creates drafts via the official WeChat APIs. Required env vars (WECHAT_APPID, WECHAT_SECRET) and python3 dependency are appropriate for this functionality.

Instruction Scope

SKILL.md and scripts confine actions to reading Markdown and image files, converting/saving HTML, optionally loading a .env, and making network calls to api.weixin.qq.com. There are no instructions to read unrelated system files, other credentials, or exfiltrate data to unexpected endpoints.

Install Mechanism

No download-from-URL install steps; dependencies are standard Python packages listed in requirements.txt. The package is instruction+code only and relies on pip for dependencies (common practice).

Credentials

Only WECHAT_APPID and WECHAT_SECRET are required for upload behavior; primaryEnv is WECHAT_APPID which is sensible. The skill does not request unrelated credentials or sensitive system config paths.

Persistence & Privilege

always is false and the skill does not request to modify other skills or system-wide agent settings. It performs local read/write for previews and temporary cover generation only (to system temp dir).

Assessment

This skill appears to do exactly what it claims: convert Markdown and, if you provide WeChat credentials, upload drafts/images to the official WeChat API. Before installing: (1) review the code if you have any doubt—source is marked unknown in the registry metadata; (2) prefer using --convert-only mode first to verify outputs without supplying credentials; (3) supply WECHAT_APPID/WECHAT_SECRET only for an account you trust (or a test account), and avoid exposing production credentials; (4) install Python dependencies in a virtualenv and run in an isolated environment if possible; (5) note the tool will make outbound HTTPS requests to api.weixin.qq.com and create temp files for generated covers—ensure your environment's network and IP whitelist (WeChat IP whitelist) are configured if needed. Overall the package is internally consistent, but the registry/source provenance is limited—exercise normal caution.

md2wechat-skill — Markdown 转微信草稿箱

将 Markdown 文件经过排版引擎转换为微信图文编辑器兼容的内联样式 HTML，并通过微信公众号 API 发送到草稿箱。

核心能力

• Markdown → 微信 HTML：完整解析标准 Markdown 语法（标题、列表、表格、代码块、引用等），自动转换为微信兼容的内联样式
• Front Matter 元数据：支持 YAML Front Matter 定义标题、作者、摘要、发布模式等
• 图片自动处理：正文内嵌的本地图片自动上传到微信 CDN 并替换为永久链接
• 封面图上传：支持指定封面图上传为微信永久素材
• 代码块深色主题：代码块自动适配深色背景样式
• 超长内容截断：超过微信 2MB 限制的内容自动安全截断

前置条件

依赖安装

pip install wechatpy markdown beautifulsoup4 requests python-dotenv pillow

微信公众号配置（仅草稿箱发布需要）

需要设置以下环境变量（可通过 .env 文件或系统环境变量）：

WECHAT_APPID=你的公众号AppID
WECHAT_SECRET=你的公众号AppSecret

获取方式：登录 微信公众平台 →「开发」→「基本配置」→ 获取 AppID 和 AppSecret。

配置模板见 {baseDir}/resources/env_template.txt。

提示：如果仅需要将 Markdown 转换为微信兼容 HTML（--convert-only 模式），则不需要配置微信密钥。

使用方式

模式一：仅转换 HTML（无需微信密钥）

将 Markdown 文件转换为微信兼容的内联样式 HTML，输出到本地文件：

python {baseDir}/scripts/md2wechat.py <markdown文件路径> --convert-only --output <输出HTML路径>

示例：

python {baseDir}/scripts/md2wechat.py ./article.md --convert-only --output ./preview.html

模式二：转换并上传到微信草稿箱

python {baseDir}/scripts/md2wechat.py <markdown文件路径> --draft --env-file <.env路径>

支持的可选参数：

• --title "自定义标题"：覆盖自动提取的标题
• --author "作者名"：指定作者
• --cover ./cover.png：指定封面图
• --output ./preview_dir/：同时保存本地预览 HTML
• --env-file .env：指定环境变量配置文件

完整示例：

python {baseDir}/scripts/md2wechat.py ./my_article.md --draft \
    --title "我的文章标题" \
    --cover ./images/cover.png \
    --env-file ./.env \
    --output ./preview/

查看帮助

python {baseDir}/scripts/md2wechat.py --help

Markdown 文件格式

基本格式

标准的 GitHub Flavored Markdown 语法均受支持：

# 文章标题

正文段落...

## 二级标题

- 无序列表项
- 列表项

1. 有序列表项
2. 列表项

> 引用文本

**加粗** 和 *斜体*

| 表头1 | 表头2 |
|-------|-------|
| 单元格 | 单元格 |

Front Matter 元数据（可选）

在文件最顶部添加 YAML 格式的元数据块：

---
title: 自定义标题
author: 作者名
summary: 文章摘要描述
publish_mode: draft
---

正文内容...

支持的字段：title、author、summary、cover、publish_at、publish_mode、account_id

图片引用

使用相对路径引用图片，上传草稿时会自动处理：

![图片描述](images/photo.png)

示例文件

示例 Markdown 文章：{baseDir}/examples/sample_article.md

脚本文件说明

文件	说明
scripts/md2wechat.py	主入口脚本（CLI）
scripts/md_converter.py	Markdown → 微信 HTML 转换引擎
scripts/html_formatter.py	HTML 内联样式适配器
scripts/wechat_client.py	微信公众号 API 客户端

Rules

1. 在执行 --draft 模式前，必须确认用户已正确配置 WECHAT_APPID 和 WECHAT_SECRET
2. 如果用户只需要转换 HTML 而不需要上传，应使用 --convert-only 模式
3. 所有脚本的工作目录应在 {baseDir}/scripts/ 下执行，以确保模块导入正确
4. 转换生成的 HTML 使用内联样式，不依赖外部 CSS 文件，确保微信兼容性