Markdown 转微信公众号排版

你需要解决的问题

将 Markdown 内容发布到微信公众号，会遇到一个核心的格式障碍：微信编辑器要求所有样式必须内联到 HTML 标签中。直接复制渲染后的 Markdown 会丢失样式，而手动编写内联 CSS 则极其繁琐且难以维护。当内容包含代码块、表格或特定排版要求时，手动处理耗时且容易出错。

技能如何工作

这个技能通过一个轻量级 Node.js 脚本，自动化了从 Markdown 到“可粘贴微信 HTML”的完整转换流程。其核心能力与关键步骤如下：

• 自动化转换与内联：脚本读取输入的 .md 文件和指定的 CSS 主题文件（如 resources/themes/default.css），自动调用 Markdown 解析器生成 HTML，并将 CSS 样式内联到每个 HTML 元素上。
• 微信适配处理：脚本会自动添加一个微信容器 (<section id="nice">...</section>)，确保内容在公众号后台的显示兼容性。它还会处理主题中的 CSS 变量，以便于多主题间的配色复用。
• 零环境依赖：执行命令时，脚本会自动在临时目录加载所需依赖包，转换完成后立即清理。用户环境只需安装 Node.js，无需预先执行 npm install，实现了真正的“开箱即用”。
• 主题化支持：通过简单更换传递给脚本的 CSS 文件路径（位于 resources/themes/），即可实现一键“换肤”，满足不同的视觉风格需求。

适用边界与注意点

• 主题变量：当前主题方案使用了 CSS 变量（如 --text-color）。如果后续需要配合其他发布工具（如 zhy-wechat-publish）上传到微信草稿箱，请确认该工具是否能在上传前展开这些变量，避免样式丢失。
• 依赖环境：虽然脚本自动处理依赖，但执行环境必须已安装 Node.js。
• 内容预览：生成的 HTML 文件可直接在浏览器中打开预览最终排版效果。发布时，需在浏览器中全选复制该页面的全部内容，然后粘贴到微信公众号图文编辑器中。
• 输入源：本技能处理的是标准 Markdown 文本，输入应为 .md 文件。