技能介绍

要解决什么问题

微信公众号后台编辑器对 Markdown 和结构化排版支持有限：标题层级、引用、代码块、列表和图片说明一旦从 Typora、Obsidian 或 CI 生成的 .md 搬过去，样式经常丢背景、字体不对齐，或者复制后图片靠左。WeChat Styler 把 Markdown 源文件 转成 全内联 style 的 HTML，目标是一次生成、整段复制到公众号编辑器，而不是再手工调 CSS。

它怎么工作

核心流程是：读取 Markdown（含 frontmatter）→ 加载 --theme 等参数 → 用 marked 解析结构 → 套用主题绑定的 Renderer Preset（不只换色，还决定标题、引用、列表、代码块、图片说明的字号与间距）→ 写出完整 HTML 文件。

可用主题包括：

zhijian：智见品牌暖纸感，默认
kami：纸感深度长文，强调 solid 背景重复声明
magazine 系列（magazine-ink / indigo / forest / kraft / dune）：五种杂志版式变体，共享 magazine-editorial 入口
elegant / modern / minimal：复古、科技教程、极简笔记等语气

常用参数有 --font-size、--line-height、--accent-color、--background-color（须 solid hex）、--max-width、--output。默认输入 article.md 时输出同目录的 article_wechat.html；不确定主题时可用预览生成器并排对比。

边界与注意点

依赖 Node.js 18+ 与 scripts/convert.mjs，不是在线 SaaS。
图片保留原始 URL，图床不可访问则公众号里仍会裂图。
为兼容公众号粘贴规则，输出避免 rgba() 与依赖 body 的背景；背景色会在 section 与 span 上重复声明，但仍建议在目标编辑器里抽查一次。
字体走完整回退栈，最终显示仍受读者设备与微信渲染影响。
扩展新主题需在 themes/ 下新增配置并指定 --theme。