微信公众号排版大师

技能文档

---
name: wechat-official-account-typesetting-master
title: 微信公众号排版大师
description: 将 Markdown、纯文本或已有文章稿件整理为可复制到公众号的微信兼容 HTML，提供语义结构优化、主题推荐、组件化卡片、图片与链接处理、预览、排版诊断和发布前校验，内置 32 套主题。当用户提到公众号排版、微信排版、文章排版、公众号美化、微信文章美化、排版到公众号、生成公众号 HTML 等时触发。
category: 内容创作
---


# 微信公众号排版大师

这是一个以“**内容气质 × 阅读节奏 × 微信兼容性 × 可复制性**”为核心的公众号排版 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. 渲染

使用：

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

常用模式：

```bash
# 指定主题
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：
- `#` / `##` / `###` 标题
- 段落、换行
- `**粗体**`、`*斜体*`、`` `行内代码` ``、`~~删除线~~`
- 无序 / 有序列表
- 引用 `>`
- 表格
- 代码块
- 图片和链接
- `---` 分隔线
- 简单脚注

组件：

```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 的表格布局。

### 代码

代码仅在确有技术内容时启用。
- 保持等宽字体
- 控制横向溢出
- 不追求过度装饰
- 代码块过长时给出截断风险提示

## 交付物

正常执行至少输出：

```text
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 模式，只允许格式变化。

使用说明

# 微信公众号排版大师

把 Markdown / 纯文本 / 已有稿件整理为可直接复制到公众号的微信兼容 HTML：理解内容 → 决定版式 → 生成 HTML → 预览 → 诊断 → 交付。

## 特性

- 内置 32 套主题，按内容类型自动推荐（科技蓝、杂志墨、暖纸感等）
- 组件化排版：重点卡片、步骤、对话、时间线、对比、图库
- 微信兼容性校验：标签闭合、高风险元素、图片路径、标题层级等 10 项诊断
- 保守整理模式：不改事实、不擅自加观点，可回退

## 快速开始

```bash
# 自动主题排版
python3 scripts/typeset.py --input "文章.md" --theme auto --output ./wechat-output

# 指定主题 / 仅生成 HTML
python3 scripts/typeset.py -i article.md -t signal-blue -o ./wechat-output --no-preview

# 列出主题 / 校验已有 HTML
python3 scripts/typeset.py --list-themes
python3 scripts/typeset.py --validate ./wechat-output/article.wechat.html
```

对助手说「帮我排版这篇公众号文章：文章.md」即可自动完成。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。