echo-md2wechat-skilllisted
Install: claude install-skill xiangzhouEcho/Echo-md2wechat-skill
# Echo md2wechat Skill — Markdown 发布到微信公众号
## Overview
把一个 Markdown 文件排版成微信公众号可用的**内联样式 HTML**，复制到剪贴板直接粘进编辑器；配置了公众号凭据时还能一键上传图片并建草稿。
**Core principle:** 本地渲染，不依赖任何付费转换服务。微信编辑器会剥离 `<style>` 和 class，所以所有样式必须内联到每个元素的 `style=""` 上——本 skill 用 markdown + Pygments 内联高亮 + premailer 内联 CSS 完成这件事。
## When to Use
- 有一个 `.md` 文件，想排版好发到公众号
- 想要「复制即粘贴」的富文本，直接贴进 mp 编辑器
- 配了 AppID/AppSecret，想自动传图 + 建草稿
- 需要把 Markdown 里的外链转成底部「参考链接」（微信外链不可点）
**Not for:**
- 自动**群发/发布**给粉丝 —— 只建草稿，群发需你在后台手动确认（安全考虑）
- 阅读数/评论等数据 —— 不涉及
- 依赖付费第三方排版 API —— 本 skill 完全本地渲染
## Quick Start
**执行位置（重要）**：在**你的 Markdown 文件所在目录**运行，并用**绝对路径**调用脚本——这样输入文件用相对名即可正确解析，脚本依赖也能就位。不要 `cd` 进 skill 目录（那会让 `article.md` 相对到 skill 目录而找不到）。本机脚本绝对路径为 `~/.claude/skills/echo-md2wechat-skill/scripts/md2wechat.py`。依赖由 uv 按脚本内联声明自动安装，无需手动 pip。
```bash
SKILL=~/.claude/skills/echo-md2wechat-skill/scripts/md2wechat.py
# 渲染并复制到剪贴板（默认，免凭据）——然后去公众号编辑器 Cmd+V
uv run "$SKILL" article.md
# 选主题 + 浏览器预览
uv run "$SKILL" article.md --theme elegant --open
# 一键建草稿（需 AppID/AppSecret + IP 白名单）
uv run "$SKILL" article.md --draft --cover cover.png
```
输入文件与 `--cover`、`--out` 都相对于你当前所在目录（即 md 文件目录），不是 skill 目录。
## Options
| 选项 | 说明 | 默认 |
|------|------|------|
| `--theme` | `default` / `elegant` / `minimal`（CLI 覆盖 frontmatter） | `default` |
| `--font-size` | 正文字号 px | 16 |
| `--no-citations` | 不把外链转成底部参考 | 默认转 |
| `--out` | 输出 HTML 路径 | 同名 `.wechat.html` |
| `--open` | 渲染后浏览器打开 | 关 |
| `--no-copy` | 不复制到剪贴板 | 默认复制(macOS) |
| `--draft` | 调官方 API 建草稿