Agent Skill

微信公众号排版大师

微信公众号全域排版与内容视觉整理 Skill。将 Markdown、纯文本或已有文章稿件整理为可复制到公众号的微信兼容 HTML,并提供语义结构优化、主题推荐、组件化卡片、图片与链接处理、预览、排版诊断和发布前校验。

内容创作·达维·来自 skill_hub·skillhub.cn ↗
skillhub install @davtime/wechat-official-account-typesetting-master
18 Stars·2.1万 综合热度·3,557 字文档·源站更新 2026-10-22

README 文档

3,557 字

微信公众号排版大师

这是一个以“内容气质 × 阅读节奏 × 微信兼容性 × 可复制性”为核心的公众号排版 Skill。

它不是单纯的 Markdown 转 HTML:先理解文章,再决定层级与视觉节奏,最后生成经过校验的微信兼容 HTML。

核心原则

  1. 内容优先:默认不改写事实、不擅自新增观点,不把排版包装成改稿。
  2. 视觉服务阅读:标题、重点、引用、图片、列表、数据、步骤必须形成明显层级。
  3. 微信兼容优先:输出以简单 HTML 标签和内联样式为主,避免依赖复杂 CSS、JS、外部字体或浏览器专属布局。
  4. 单次完成闭环:分析 → 风格决策 → 结构整理 → HTML → 预览 → 校验 → 交付。
  5. 可回退:任何智能结构化步骤都应保留原稿,不直接覆盖用户源文件。

默认工作流

1. 接收与识别

支持:

  • .md Markdown
  • .txt 纯文本
  • 已有 HTML(只做清理、兼容化与视觉统一)
  • 对话中直接提供的文章内容

先识别:

  • 标题 / 副标题
  • 一级、二级、三级内容层级
  • 导语、正文、总结、CTA
  • 列表、步骤、表格、引用、金句、代码、数据
  • 图片、图注、外链
  • 访谈、问答、时间线、对比内容

2. 智能整理(默认开启,但保守处理)

可做:

  • 补齐明显缺失的层级标记
  • 把连续并列句整理成列表
  • 将明显的步骤段整理为步骤组件
  • 将“人物:内容”形式整理成对话组件
  • 将连续图片整理为图库组件
  • 为少量核心句添加重点强调
  • 为图片后的说明文字识别为图注
  • 在章节转场位置增加轻量分隔

不可做:

  • 改变事实、数据、结论
  • 擅自重写文章观点
  • 为了好看而大量加粗
  • 把每一段都做成卡片
  • 虚构小标题或摘要

3. 风格决策

用户明确指定主题时直接使用。

未指定主题时,根据内容类型自动选择:

  • 深度分析 / 长文 → editorial-ink
  • 科技 / AI / 产品 → signal-blue
  • 商业 / 管理 / 职场 → executive-graphite
  • 人文 / 随笔 / 生活 → warm-paper
  • 教程 / 工具 / 方法论 → utility-green
  • 资讯 / 快讯 / 周报 → newsroom-red
  • 品牌 / 产品故事 → modern-cream
  • 年轻 / 社交 / 生活方式 → soft-coral
  • 极简 / 观点 / 设计 → ink-minimal
  • 清晨 / 阅读 / 轻资讯 → sea-salt-morning
  • 自然 / 植物 / 松弛感 → pine-smoke
  • 品牌 / 建筑 / 极简商业 → nordic-studio
  • 情绪 / 影像 / 生活记录 → sunset-film
  • 阅读 / 书评 / 文化评论 → wine-reading
  • 科普 / 数据 / 冷静分析 → glacier-silver
  • 年轻消费 / 时尚 / 社交 → berry-manual
  • 东方生活 / 茶 / 雅集 → sandalwood-atelier
  • 旅行 / 摄影 / 回忆 → film-diary

用户要求“高级、克制、耐看”时优先低饱和主题。 用户要求“醒目、传播感强”时提高标题、重点框、数字模块的视觉对比,但仍保持移动端可读性。

4. 渲染

使用:

python3 {baseDir}/scripts/typeset.py \
  --input "文章.md" \
  --theme auto \
  --output "./wechat-output"

常用模式:

# 指定主题
python3 {baseDir}/scripts/typeset.py -i article.md -t signal-blue -o ./wechat-output

# 仅生成 HTML,不预览
python3 {baseDir}/scripts/typeset.py -i article.md -t editorial-ink -o ./wechat-output --no-preview

# 强制使用保守整理模式
python3 {baseDir}/scripts/typeset.py -i article.md -t auto -o ./wechat-output --safe

# 列出主题
python3 {baseDir}/scripts/typeset.py --list-themes

# 校验已有 HTML
python3 {baseDir}/scripts/typeset.py --validate ./wechat-output/article.wechat.html

支持的 Markdown / 组件语法

普通 Markdown:

  • # / ## / ### 标题
  • 段落、换行
  • 粗体、斜体、` 行内代码 、~~删除线~~`
  • 无序 / 有序列表
  • 引用 >
  • 表格
  • 代码块
  • 图片和链接
  • --- 分隔线
  • 简单脚注

组件:

:::callout[核心观点|important]
这里是一条核心结论。
:::

:::steps[操作步骤]
准备素材
打开编辑器
复制到公众号后台
:::

:::dialogue[访谈]
主持人:你为什么开始做这件事?
作者:因为我发现……
:::

:::timeline[发展历程]
2022:项目启动
2024:正式发布
2026:进入新阶段
:::

:::compare[方案 A vs 方案 B]
成本低 | 功能完整
上手快 | 扩展性强
:::

:::quote[作者的话]
真正重要的不是装饰,而是阅读节奏。
:::

:::gallery[现场照片]
![图1](https://example.com/1.jpg)
![图2](https://example.com/2.jpg)
![图3](https://example.com/3.jpg)
:::

公众号视觉规则

标题层级

  • H1:只作为文章主标题,不重复渲染。
  • H2:作为主要章节标题,形成最强的内容导航。
  • H3:作为 H2 内部的小节标题。
  • 不为了视觉效果无限增加标题层级。

正文

  • 单段默认保持 1–4 行移动端可读长度。
  • 遇到超过约 6 行的连续文字,优先检查是否需要拆段或加小标题。
  • 不使用大面积居中正文。
  • 不让正文颜色过浅。

强调

一篇文章建议只保留 1–3 类强调:

  • 粗体:关键词
  • 重点块:核心结论
  • 引用:金句 / 原话

图片

  • 优先居中、等比、圆角幅面。
  • 图片下方的短句优先识别为图注。
  • 不擅自修改图片 URL。
  • 本地图片会复制到输出目录的 assets/ 以便预览;真正粘贴到公众号时,仍应替换成公众号可访问的图片资源。

链接

  • 默认保留正文链接。
  • 对特别长的外链,可在诊断中建议转为“参考链接”区,而不是强制改写。
  • 不自动生成虚假的链接摘要。

表格

公众号复制环境对复杂表格支持不一,因此:

  • 首选简洁表格;
  • 复杂表格建议在排版诊断中标记为“建议图片化 / 拆卡片”;
  • 不使用依赖 CSS grid 的表格布局。

代码

代码仅在确有技术内容时启用。

  • 保持等宽字体
  • 控制横向溢出
  • 不追求过度装饰
  • 代码块过长时给出截断风险提示

交付物

正常执行至少输出:

wechat-output/
├── article.wechat.html      # 微信兼容成品
├── article.preview.html     # 独立预览页
├── article.report.json      # 排版诊断与校验报告
└── assets/                  # 本地资源副本(如有)

必要时增加:

  • article.structured.md:结构化后的中间稿
  • article.cleaned.html:清理版 HTML
  • article.preview.png:若运行环境支持截图,则生成视觉快照

禁止覆盖原始稿件。

诊断与发布前检查

生成 HTML 后必须做以下检查:

  1. 标签是否闭合。
  2. 是否含脚本、外部样式表、复杂 CSS 依赖。
  3. 是否存在 position: fixed、动画、视频播放器等高风险元素。
  4. 图片是否存在本地相对路径或明显失效 URL。
  5. 标题层级是否跳级严重。
  6. 是否存在超长段落。
  7. 表格是否过宽。
  8. 是否有空标题、空链接、重复分隔线。
  9. 重点标记是否过量。
  10. 输出 HTML 是否包含微信无法稳定保留的复杂结构。

风险等级:

  • PASS:可直接进入复制测试
  • CHECK:视觉或资源方面需要人工看一眼
  • BLOCK:存在明显不适合交付的结构

主题体系

当前内置 32 套主题,见 themes/themes.json。

主题差异不仅体现在配色,还包括:

  • 标题视觉语言:下划线、侧边栏、底色块、细规则、徽章式标题等;
  • 正文密度:行高、段距、阅读留白;
  • 容器语言:圆角、边界、内距;
  • 图片语言:图片圆角与上下节奏;
  • 信息组件:表格、代码、引用、重点卡片的视觉重量。

它们不是单纯换颜色,而是同步调整:

  • 标题层级
  • 正文宽松度
  • 引用方式
  • 重点卡片
  • 图片边角
  • 分隔线
  • 表格风格
  • 代码块风格

预览与复制

预览默认使用本地 article.preview.html,不会把用户文章强制上传到第三方服务。

如用户明确需要在线复制页,可在配置文件中启用自定义 copy_endpoint,但:

  • 不得将第三方域名写死在代码中;
  • 发送前应提示用户内容会离开本地环境;
  • 默认关闭。

行为约定

  • 用户只说“排版” → 自动分析 + 自动主题 + 安全整理。
  • 用户说“换个风格” → 保留内容与结构,只更换主题。
  • 用户说“更高级” → 优先调整留白、层级和强调密度,不堆色彩。
  • 用户说“更有传播感” → 强化开头、金句、数字和小标题的视觉节奏,但不改原意。
  • 用户说“只要 HTML” → 不输出冗余解释,只生成 HTML 与报告。
  • 用户说“不要改文字” → 严格 safe 模式,只允许格式变化。

同分类其他技能

查看全部 ›