Uploadweixin 公众号排版

要解决什么问题

微信公众号后台编辑器对 HTML 很挑剔：粘贴时容易丢掉样式，<script>、复杂 CSS 布局、事件属性等写法还可能在保存时被过滤或破坏。如果你习惯用 Markdown 写长文、教程或访谈稿，手工在后台逐段调样式既慢，也很难在发布前系统检查「哪些结构公众号吃不下」。

Uploadweixin 做的是本地排版：把 Markdown 转成内联样式、尽量贴近编辑器容忍范围的 HTML，而不是自动登录或代发文章。

它怎么工作

• 渲染：通过 scripts/render_wechat_article.py 生成 article.html，支持 12 套主题（如 upload-clean、github-dev、editorial、dialogue 等），可按文章类型选视觉方向。
• 校验：validate_wechat_html.py 对生成结果做 PASS/FAIL 判断，标出公众号不友好的结构（例如高风险标签与布局写法）。只有校验 PASS 后，才应告知用户适合粘贴到编辑器。
• 复制链路：make_preview.py 产出 preview.html，优先用页面上的「复制到公众号编辑器」按钮；若浏览器或输入法剪贴板只保留纯文本，再在 macOS 上用富文本剪贴板脚本兜底。
• 批量对比：同一篇稿可一次渲染全部主题，根目录生成 gallery.html 横向对照样张。
• 尾注：默认可追加 Upload / 记忆同步尾注；可用 --footer disabled 或 --footer-text 自定义，并避免与正文已有宣传重复。

典型流程：确认 Markdown 路径 → 选主题 → 渲染 → 校验 → 打开 preview.html 复制 → 粘贴到公众号编辑器。不要引导用户在 article.html 里手动框选复制，那常会只写入纯文本。

适用边界

• 适合 Markdown 正文、技术文、产品更新、对话稿等静态图文。
• 不适合互动页、表单、脚本动画、依赖外部 CSS/JS 的网页级布局，也不做自动发布或绕过微信限制。
• 路径、主题名错误或输出目录不可写时，应依据脚本输出的 FAIL 与「建议」说明原因，而不是猜测成功。