# Md Pushplus > 当用户要把一个 Markdown 文件（如日报、研报、复盘、周报、笔记、待办、生成好的报告）渲染成 HTML 并通过 PushPlus 推送到微信/邮箱时使用。 典型说法："把这份日报推送到我微信""用 pushplus 发一下这个 md""把 report.md 渲染成 HTML 发给我""推送到 pushplus""把刚生成的报告 push 出去""每天把宏观日报发到我手机"。 也适用于：让任何上游 skill（ch-news-reporter / a-stock-* / usmarket-report 等）产出的 Markdown 报告，一键变成带样式的 HTML 推送通知。 默认用仓库共享的 shared/html_report 主题模板渲染成 HTML 再推送，与各报告型 skill 的网页版同一套观感。 本 skill 只做「Markdown→HTML 渲染 + PushPlus 发送」这一件事；不负责生成报告内容本身，也不做邮件 SMTP、Server酱、钉钉/飞书等其它推送渠道（仅 PushPlus）。 - Skill: `chinfi-codex/md-pushplus` (Agent Skill, multi-file: 5 files) - Install (CLI): `npx skillmds@latest add chinfi-codex/md-pushplus` - Raw SKILL.md: https://api.skillmd.com/api/skills/chinfi-codex/md-pushplus/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: chinfi-codex (https://skillmd.com/u/chinfi-codex) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/chinfi-codex/md-pushplus --- # md-pushplus 把指定的 Markdown 文件渲染成带样式的 HTML，再通过 [PushPlus](https://www.pushplus.plus/doc/) 推送到微信、邮箱等渠道。 ## 目标 用户已经有（或刚生成）一份 Markdown，想把它「变好看 + 送到手机/邮箱」。本 skill 负责后半段——渲染与发送，是一个确定性的收尾动作，报告内容本身由用户或上游 skill 提供。 ## 何时用 / 不用 - **用**：用户给出一个 `.md` 文件路径（或上一步刚写出的报告文件），要求推送、发送、push、通知到微信/邮箱，并提到 pushplus，或没指定渠道但想"发到手机"。 - **不用**：用户要的是生成报告内容（那是上游 skill 的事）；或明确要走邮件 SMTP、Server酱、钉钉、飞书等非 PushPlus 渠道（本 skill 只接 PushPlus）。 ## 默认行为（不要问，直接这么做） 1. **推送格式默认 HTML**：PushPlus 的 `template` 固定 `html`，正文一律先渲染成 HTML 再发，不发裸 Markdown、不发纯文本。 2. **渲染默认用共享主题模板**：走 `shared/html_report` 的 Markdown 引擎与主题 CSS（默认 `default` 主题，即 AlphaVault 站点风格），跟 a-stock-* / usmarket / ch-news-reporter 出的网页版报告同一套观感。**除非用户点名要别的主题或要极简体积，否则不要切换。** 用户没提要求时，这两条就是默认值，`python scripts/md_to_pushplus.py 报告.md` 一条命令即可，无需额外参数。 ## 前置：token PushPlus 的 token 从环境变量 `PUSHPLUS_TOKEN` 读取（在 [pushplus.plus](https://www.pushplus.plus/) 登录后于「一对一推送」页面获取）。也可用 `--token` 显式传入。若两者都没有，发送会失败并提示——这时向用户要 token，不要瞎编。 ## 工作流程 1. **确认输入**：拿到要推送的 Markdown 文件路径。如果是上一步刚生成的报告，直接用那个路径。 2. **想好标题**：标题是用户在微信/邮件里第一眼看到的东西。 - 默认会取 Markdown 里的第一个 `# 一级标题`；没有就用文件名。 - 如果默认标题不够清楚（比如就是个日期），**主动替用户拟一个有信息量的标题**（如「6/24 宏观日报：美债走高、黄金回落」），用 `--title` 传入。这是模型该做的判断，别留给脚本。 3. **先 dry-run 自检**（推荐）：加 `--dry-run --save-html /tmp/preview.html` 先渲染不发送，脚本会打印推送包的字符数与 UTF-8 字节数，并把体积拆成 `css + body + 外壳` 三块。**看字节数那个**：PushPlus 文档没写清 4 万的上限是字符还是字节，而一个中文字符占 3 字节，所以脚本按字节这一侧保守判定——一份 1.4 万字符的中文日报就已经接近上限了。顶到上限看下面「常见失败」。预览文件按手机视口打开看最准——推送主要在微信里读。 4. **发送**：去掉 `--dry-run` 正式推送。脚本返回 PushPlus 的 JSON，`code==200` 即成功。 5. **如实回报**：把发送结果（成功 / 失败原因）告诉用户，并说明用的是哪套渲染（主题名或 inline 降级）。失败时按「常见失败」排查，别假装成功。 ## 命令 ```bash # 最简：默认 html 模板 + 共享 default 主题，标题自动从 # 标题或文件名推断 python scripts/md_to_pushplus.py 报告.md # 显式标题（推荐——一个好标题比正文更影响打开率） python scripts/md_to_pushplus.py 报告.md --title "6/24 宏观日报：美债走高、黄金回落" # 换共享主题：claude（暖色衬线）/ print（黑白衬线，适合转 PDF） python scripts/md_to_pushplus.py 报告.md --theme claude # 先自检不发送，并保存一份 HTML 预览（存的就是要推的那份，所见即所推） python scripts/md_to_pushplus.py 报告.md --dry-run --save-html /tmp/preview.html # 降级成纯内联样式（体积小、兼容老邮件客户端） python scripts/md_to_pushplus.py 报告.md --renderer inline # 群组推送（一对多）/ 指定渠道（邮件） python scripts/md_to_pushplus.py 报告.md --topic 群组code python scripts/md_to_pushplus.py 报告.md --channel mail ``` 参数：`--token`（默认读 `$PUSHPLUS_TOKEN`）、`--template`（PushPlus 模板，默认 `html`）、`--renderer`（`theme` 默认 / `inline` 降级）、`--theme`（`default` 默认 / `claude` / `print`）、`--topic`（群组 code，一对多）、`--channel`（`wechat`|`mail`|`webhook`|`cp`|`sms`）、`--save-html`、`--dry-run`。 ## 渲染说明 **默认路径（`--renderer theme`）**：用 `shared/html_report` 的 Markdown 引擎和主题 CSS，但**推出去的是一个自包含的 HTML 片段**，不是整页文档——一个带作用域的 `
`，里面是内联的主题 CSS 加报告正文。 为什么是片段不是整页，三条都是在真实推送页面（pushplus.plus/shortMessage/…）上实测出来的： - **PushPlus 把 content 以 innerHTML 注入自己的详情页，页面里的 `