技能介绍

要解决什么问题

微信公众号后台编辑器对富文本的约束很硬：样式必须内联、文字节点要包在 <section> 里，一旦漏包或带上 class、外部 CSS，粘贴后整篇会「裸奔」。很多人用 Markdown 写稿，却要在后台手工调标题、引用和代码块，关键词下划线这类高频排版更是重复劳动。本技能把一篇稿从「结构化的 Markdown」变成只含正文区域、可直接复制的 HTML 片段，并尽量用脚本做一次严格校验，减少粘贴后样式丢失。

技能如何工作

工作流分两条路径：

快速路径：标准 .md 交给 scripts/render_gzh.py，完成结构归一化（例如合并重复的 ## 01 + 正式标题写法）、启发式 1～2 处关键词下划线、校验，并在源文档目录生成带双复制按钮的预览页。
高保真路径：当嵌套列表、引用内列表、原始 HTML 块导致快速路径拒绝，或你需要主题专属组件（票据风、橄榄手记等）时，再读 references/theme-*.md 与 references/common-components.md，按「文章类型 → 组件配方」装配 HTML。

主题默认 摸鱼绿（moyu-green），除非你明确指定其它主题或走自定义主题生成。非 Markdown 输入需先按 references/format-normalize.md 转成草稿（docx / PDF / 纯文本各有规则）。交付物是预览 HTML：「复制到公众号」为内联样式富文本；「复制到头条号」由 render_toutiao.py 生成头条原生结构，不含主题卡片 CSS。

生成时会主动做几件容易踩坑的事：标题不自动加 01/PART/英文标签；正文段落尽量每段标 1～3 个短语下划线；正文标点倾向全角（代码块内保持原样）；引用里的 > - 列表会聚合成一个列表块而不是多条碎引用。

适用边界

产物是纯正文，不含封面、目录、引言卡、署名、END、点赞 CTA 等品牌尾块——原文末尾的运营段落会被排除。
平台红线由校验脚本兜底：禁止 script、class/id、position:fixed 等；样式必须内联。若环境无法跑校验，仍会给出预览并说明「未运行自动校验」，不能谎称已通过。
复杂版式或新视觉需走 references/theme-generator.md 自定义主题，并登记进 theme-index.md 后才与内置主题同权使用。