Skip to content

v0.3.0

Choose a tag to compare

@helloworldtang helloworldtang released this 23 Sep 03:41
· 4 commits to main since this release

变更

  • 可选主题(配色覆盖):markdown_to_html(text, theme={...}) 按主题着色,键与 wechat-publish-service 的 ThemeConfig 对齐;不传 theme 时配色与历史版本一致(回归测试保障)。
  • 列表 → section 条目:ul/ol 逐条改为 <section>• 文本</section>(有序列表保留 N. 序号前缀);嵌套列表或 li 含块级元素时整段放弃改写、原样保留。
  • 外域链接内联成「文字,URL」:mp.weixin.qq.com 互链保持真锚点;链接文字含标签或已含 URL 时不冒险改写。

为什么

2026-09 线上实测(拉回公众号后台实际存储的 HTML 复核):

  • 公众号编辑器会把 li 内「内联元素+后续文本」拆成独立块——<strong>标签</strong> 与「:内容」断成两行,strong/span 一视同仁,列表标签在正文里不可用;
  • 外域锚点会被编辑器整个删除只留文字(连样式都不留),URL 信息彻底丢失。

两条规则与 wechat-publish-service 发布链路的优化层同构:经接口发布时幂等无害(双保险),直接粘贴编辑器场景自此受保护。验证方式:发布测试稿 → draft/get 拉回微信存储 HTML 比对,用户真机验收通过(2026-09-22/23)。

升级命令

pip install -U wechat-md==0.3.0

消费方指引

  • 经 wechat-publish-service(yyps)发布的内容无需升级也有同等保护(服务端优化层已上线),升级只是让本地直出 HTML 与发布产物一致;
  • 引用 GitHub 源请锁 tag:.../archive/refs/tags/v0.3.0.tar.gz,不要引滚动的 main;
  • 行为变更集中在列表与外链的输出结构,若下游对这两类 HTML 做了断言,升级前请同步期望值。