前言¶
写公众号时，常见流程是先在 Markdown 或笔记里起草，再粘进公众号编辑器里逐段调样式。编辑器里的最终效果往往和草稿不一致，改一轮就要在浏览器里反复预览。若希望先在本地看到接近白底正文、常见字号行距的版面，再决定哪些段落可以整段复制，需要一个不依赖在线排版服务、也不把正文发到第三方 API 的轻量方案。
下面介绍 SkillHub 上的 公众号排版预览器（@user_9e6539c8/wechat-markdown-preview）：用本地 Python 脚本把 Markdown 转成单页 HTML，在浏览器里预览后再复制到公众号后台。
这是什么¶
公众号排版预览器 将 Markdown 渲染成适合公众号复制预览的本地 HTML。发布者为 SkillHub 社区用户 user_9e6539c8（SkillHub 页面标注作者为 Abel），版本 1.0.0，分类为 content-creation，来源为 community。Skill 标签标明 requires_api_key=false，说明不依赖外部 API Key。
SkillHub 页面简介还提到：适用于公众号排版、Markdown 预览、微信排版、文章预览、公众号样式、复制到公众号等场景，并包含本地 Python 脚本。截至资料抓取时，SkillHub 显示评分 100000、下载 1783 次。
核心功能¶
根据 Skill 包内 SKILL.md 与 scripts/wechat_markdown_preview.py，当前可核实的能力如下。
- 本地渲染：读取 UTF-8 文本的 Markdown 文件，生成带内联样式的 HTML 预览页，默认输出文件名为
wechat_preview.html。 - 版式取向：页面为白底、最大宽度约 720px、系统字体与常见行高；二级标题带绿色左边框，贴近常见公众号正文阅读感。
- Markdown 子集：脚本按行解析，支持一级标题（
#）、二级标题（##）、无序列表（-）以及普通段落；空行渲染为换行。 - Agent 工作流：安装为 Skill 后，Agent 会先确认输入是否清楚，再优先调用脚本生成初稿，结合输出给出路径与后续建议（见 Skill 内「工作流」「质量要求」）。
说明：Skill 简介提到可生成 Markdown、JSON、CSV、HTML 等交付物；当前包内主脚本实现的是 HTML 预览 这一条路径。复杂表格、代码块、图片等需自行在 Markdown 侧补齐，或后续扩展脚本。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在 SkillHub 上安装时，官方提示可让 AI 按 SkillHub 安装文档 处理，坐标为：
@user_9e6539c8/wechat-markdown-preview
若本机已安装 SkillHub CLI，在 当前 Agent 的 skills 目录 下执行（--dir 必填，否则默认装到 ./skills/ 可能不会被 Agent 加载）：
skillhub install wechat-markdown-preview --namespace user_9e6539c8 --dir <你的 skills 目录>
常用客户端 skills 目录（来自 SkillHub 安装文档）：
| 环境 | 路径 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
未安装 CLI 时，可先执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装完成后，按各客户端说明重启或刷新 Agent，使 Skill 被识别。
典型用法¶
在已安装 Skill 的目录中，对一篇 Markdown 源文件运行官方快速用法：
python3 scripts/wechat_markdown_preview.py article.md --out out/wechat
含义简要说明：
article.md：待渲染的 Markdown 源文件路径。--out out/wechat：输出目录；不存在时会自动创建。
成功时终端会打印预览文件路径，例如 out/wechat/wechat_preview.html。用浏览器打开该 HTML，检查标题层级与段落换行是否符合预期，再从页面中选取内容复制到公众号编辑器。
若通过 Cursor 等 Agent 使用，可直接说明「用公众号排版预览器处理某篇 Markdown」，Agent 会按 Skill 工作流调用上述脚本并回报输出路径。
适用场景与注意¶
适合谁
- 习惯用 Markdown 写稿、需要在发布前本地看一眼「白底正文」效果的运营或作者。
- 希望排版过程留在本机、不配置第三方 API 的团队或个人。
限制与注意
- 渲染器是轻量行解析，不是完整 CommonMark；多级标题、引用、代码块、链接等需在成稿前自检，或接受在公众号编辑器里二次调整。
- 复制到公众号后，平台仍可能改写部分样式；本地 HTML 用于 预览与选段，不能替代后台最终校对。
- Skill 要求 Agent 不要编造外部事实；输入材料过少时，应明确让用户补充字段（见 Skill 质量要求）。
结尾¶
公众号排版预览器 把「Markdown 起草 → 本地 HTML 预览 → 复制进公众号」收成一条可脚本化的路径，并与 SkillHub、Cursor 等 Agent 工作流对齐。需要安装或查看说明时，可打开官方 Skill 地址：
https://api.skillhub.cn/user_9e6539c8/wechat-markdown-preview
SkillHub 展示页：
https://www.skillhub.cn/skills/user_9e6539c8/wechat-markdown-preview
