技能介绍

要解决的问题

微信公众号正文不接受外部 CSS，Markdown 直接粘贴常常样式丢失、表格不可读、长文超限时难以维护。这个技能面向技术写作场景，把 Markdown 转换为微信兼容的 HTML，并可选择推送微信草稿箱或掘金草稿箱。

技能如何工作

核心流程分三层：md2wechat_html.py 只负责转换，push_daily.py 执行转换后推微信，push_juejin.py 推掘金。转换时支持标题、正文、粗体、链接、行内代码、代码块、引用块、表格等格式，并把 CSS 内联到 style 属性。文章模式默认提供 7 种预设样式，可用自然语言匹配，也可用 --config 指定；新闻模式面向板块化日报，需明确指定。推送微信前会读取 frontmatter 的 title 与 digest，若缺少摘要则要求生成 120 字以内中文摘要，避免脚本硬截断。输出超过 20000 字符时会按 H2 自动拆分并添加（上）（中）（下）。掘金路径会解析 frontmatter、上传本地图片到掘金图床并替换为 CDN URL，最后创建或更新草稿。

适用边界与注意点

仅转换时没有额外前置；推送微信必须存在 ~/.md_push_wechat/config.yaml 并填写 appid 与 secret，不得自动查找或创建。掘金依赖 juejin.cookie，有效期约 30 天。图片上传为尽力而为，失败会保留原引用。该技能不解决内容事实核验、版权授权或微信审核规则，只处理格式转换、摘要整理与草稿推送。