技能介绍

它解决什么问题

把 Markdown 直接粘进微信公众号后台，经常会出现列表编号丢失、代码块样式错乱、正文与代码主题互相干扰等问题。公众号编辑器的 HTML 解析器并不标准：它会丢弃部分列表标记，把空白文本节点当成额外列表项，也会破坏依赖外部 CSS 的排版。这个技能的目标是把 Markdown 先渲染成一份可独立交付的 HTML，再粘贴到下游编辑器，减少这类二次解析造成的排版退化。

它如何工作

核心是 scripts/render-markdown-html.js。它把 Markdown 转换成 standalone HTML，并把样式拆成几个独立层次：basic-theme、text-theme、code-theme 与 font-theme。渲染时可以通过参数选择文本主题、代码主题和字体，例如 --text-theme 控制正文观感，--code-theme 控制 pre code 的语法高亮，两者默认值不同且能各自切换。

关键步骤包括：先检查请求中是否提到 wechat.bmpi.dev，若是则读取 references/wechat-bmpi-analysis.md 中的站点机制说明；然后在技能目录内安装依赖并执行渲染脚本；最后校验输出是否包含四个样式块，并确认 --text-theme 与 --code-theme 可以独立变化。为了贴合公众号编辑器，脚本内置了两条不可关闭的后处理规则：对不含嵌套列表的列表项，展平内部包裹并合并样式；同时清除列表边界和兄弟列表之间的空白文本节点，避免编辑器把空格或换行解析成额外空列表项。

适用边界

输出是 standalone HTML，适合复制到公众号后台或同类编辑器，而不是通用前端框架。主题切换只覆盖渲染脚本定义的文本、代码与字体选项；--custom-css-file 仅在 --text-theme custom 时生效。列表标记在公众号预览里依赖 CSS ::marker，如果从编辑器复制文本到外部，标记可能不会以文本节点形式出现，需要以视觉预览为准。