微信公众号排版大师

概述

这是一个以“内容气质 × 阅读节奏 × 微信兼容性 × 可复制性”为核心的公众号排版 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 模式，只允许格式变化。