最近我一直研究 Claude Code 工作流，自动化搜集素材、处理素材、写文章、自动配图、自动排版、自动同步到各个平台。

从今天开始我将陆续公布我最近研究和实战的结果，帮助大家学习Claude Code 工作流，如何实现各种复杂工作的自动化...

今天将分享如何：一句话搞定公众号排版、封面生成，和一键发送到公众号草稿箱，你只需点下发布即可。

写公公众号文章的同学，相比都有这样的感悟。

排版比写文章累多了...

以前的流程是这样的：写好文章复制到 mdnice 或者 135 编辑器，选模板，调样式，把图片一张张上传到微信后台，再复制粘贴到公众号编辑器。一篇文章排版要几十分钟，而且还需要不断的调整各种格式和样式，如果图再多一点，更是麻烦，全花在重复劳动上。

现在我跟 Claude Code 说一句"排版这篇文章"，从到发布到草稿箱，整个过程大概也就2-3分钟。

这篇文章分享我做自己通过Claude Code 做的这个开源工具怎么用。

它解决什么问题

微信公众号编辑器有三个让人头疼的限制：

不支持 CSS 类名。你在 HTML 里写 class="highlight"，微信直接给你删掉。所有样式必须写成内联的 style="color: red; font-size: 16px"——每个标签都要写一遍。

不支持外部链接。你在文章里放一个 [点击这里](https://...) ，微信会把链接吃掉，读者看到的就是一段没有链接的纯文本。

图片必须在微信服务器上。你本地的图片、别的 CDN 的图片，粘贴进去都不显示，必须先上传到微信的素材库拿到 mmbiz.qpic.cn 的地址。

⚡ 核心问题

这三个限制叠在一起，意味着你没法直接把 Markdown 转成 HTML 粘贴进去，得有一个专门处理微信兼容性的中间层。

小互排版神器的优势

市面上做 Markdown 转微信的工具不少，mdnice、135 编辑器、墨滴都能用。但用下来总觉得差点意思。

它能理解你在写什么：传统工具是机械转换，把 Markdown 语法一对一翻译成 HTML。但是如果你 Markdown 本身格式就不好，你还会要去手动去调。很多人还是嫌麻烦，还有如果不是Markdown的文章可能就无效。

我这个工具多了一层 AI 分析：它会读你的文章，判断你内容的结构和具体内容部分适合什么排版，它会自动分析自，然后自动做排版增强。检测到对话体内容套上聊天气泡，发现连续截图变成横向画廊，识别到金句加高亮框。你不用手动调，它替你想好了。

具体操作步骤

打开 Claude Code，说：

排版这篇文章 /path/to/article.md

Claude 会做四件事：

1. 读文章，分析内容结构

它会判断文章类型（访谈？教程？深度分析？），然后自动做一些排版增强。比如检测到对话体内容会套上聊天气泡容器，检测到金句会加高亮框，连续多张图片会变成横向滚动画廊。

💡 AI 排版的核心优势

这一步是 AI 排版比纯工具排版强的地方：它理解内容，不是机械转换。

2. 打开主题画廊

浏览器里会弹出一个页面，用你的真实文章渲染了 30 个主题：

不是那种用 Lorem ipsum 假文字预览的效果图，是你自己的文章、你自己的段落、你自己的标题。

30 个主题分五类：

•深度长文：报纸、杂志、墨韵、咖啡——严肃、留白多、适合万字长文

•科技产品：字节蓝、GitHub、少数派、暗夜——现代、代码友好

•文艺随笔：赤陶、薄荷、日落、薰衣草——有温度、有情绪

•活力动态：运动、包豪斯、中国风、微信原生——醒目、节奏快

•模板系列：简约/聚焦/精致/醒目 × 多种配色——同一布局换个色

点一个主题按钮，预览区立刻切换，不用等渲染：

主题预览效果

橙色的「推荐」标签是 AI 根据文章内容推荐的主题，不影响选择你喜欢哪个选哪个。还可以选择字体大小...

选好了有两种操作方式：

•绿色按钮：点确认，回到 Claude Code 告诉它主题名（比如"报纸"），Claude 会帮你排版+推送

•灰色按钮：直接复制 HTML 到剪贴板，去公众号后台粘贴——不需要回到 Claude

3. 生成微信兼容 HTML

所有样式写成内联、外链自动转脚注、图片路径自动处理。输出一个 HTML 文件，打开就是手机上看到的效果。

4. 推送到草稿箱（可选）

如果配了公众号 AppID 和 AppSecret，可以直接推到草稿箱，图片自动上传到微信 CDN。

最懒的安装方式：让 AI 帮你装

如果你已经在用 Claude Code、Codex 或 OpenClaw，最简单的方式就是把仓库地址丢给它：

帮我安装这个公众号排版技能 https://github.com/xiaohuailabs/xiaohu-wechat-format

AI 会自己 clone 仓库、装依赖、创建配置文件。你什么都不用管。

这招在 Cursor、Windsurf 这类 AI 编辑器里也能用——打开终端对话框，把上面那句话粘进去就行。

手动安装（完全小白版）

如果你更喜欢自己来，或者上面那招没成功，跟着下面一步步走。

1. 确认你有 Claude Code：

打开终端（Mac 按 Cmd+空格 搜"终端"），输入：

claude --version

如果显示版本号（比如 2.1.81），说明已经装好了。如果提示 command not found，先去 claude.ai/code 装 Claude Code。

2. 确认你有 Python 3：

python3 --version

Mac 自带 Python 3。如果没有，装 Homebrew 后 brew install python3。

3. 一条命令安装：

复制下面这整条命令，粘贴到终端回车：

mkdir -p ~/.claude/skills 
  && git clone https://github.com/xiaohuailabs/xiaohu-wechat-format.git ~/.claude/skills/xiaohu-wechat-format 
  && cd ~/.claude/skills/xiaohu-wechat-format 
  && pip3 install markdown requests 
  && cp config.example.json config.json

它会自动创建目录、下载代码、装依赖、创建配置文件，全部一步到位。如果你只想排版复制粘贴，到这步就够了，不需要改 config.json 里的任何内容。

4. 验证安装成功：

随便找一篇 Markdown 文件试一下：

python3 scripts/format.py --input /path/to/any-article.md --gallery

如果浏览器弹出一个画廊页面，恭喜，装好了。

不用 Claude Code 也能用

核心是两个 Python 脚本，不依赖任何 AI 框架：

"color:#6a9955"># 打开主题画廊
python3 scripts/format.py --input article.md --gallery

"color:#6a9955"># 直接指定主题排版
python3 scripts/format.py --input article.md --theme newspaper

"color:#6a9955"># 推送到公众号草稿箱
python3 scripts/publish.py --dir /tmp/wechat-format/output/ --cover cover.jpg

支持Codex、Gemini CLI、OpenClaw 小龙虾等，包括国内各种变体小龙虾也可以...甚至纯命令行都行。

Claude Code 的 SKILL.md 只是让对话触发更自然，底层跑的就是这两个脚本。

配置公众号推送

如果只是排版复制粘贴，不需要任何配置。

要用自动推送功能，编辑 config.json：

{
  "wechat": {
    "app_id": "你的AppID",
    "app_secret": "你的AppSecret"
  }
}

去公众号后台 → 设置与开发 → 开发者后台基本配置，拿到 AppID 和 AppSecret。

地址：https://developers.weixin.qq.com/

不会编辑也没关系，把拿到的 AppID 和 AppSecret 发给Claude Code、Codex、OpenClaw等...

它会帮你自动配置好

⚠️ IP 白名单

必须把你的公网 IP 加到公众号后台的 IP 白名单里，否则会报 40164 错误。每次换网络环境（比如换 WiFi、用热点）IP 都会变，得重新加。

自定义主题

所有主题都是 JSON 文件，放在 themes/ 目录下。格式大概长这样：

{
  "name": "我的主题",
"colors": {
    "accent": "<span color:#b5cea8"="" style="margin: 0px; padding: 0px; box-sizing: border-box;">6a9955">#FF6B35",
    "bg": "<span color:#b5cea8"="" style="margin: 0px; padding: 0px; box-sizing: border-box;">6a9955">#FFFAF5",
    "text": "<span color:#b5cea8"="" style="margin: 0px; padding: 0px; box-sizing: border-box;">6a9955">#2D2D2D"
  },
"heading": {
    "h2": {
      "font-size": "22px",
      "font-weight": "bold",
      "color": "<span color:#b5cea8"="" style="margin: 0px; padding: 0px; box-sizing: border-box;">6a9955">#FF6B35"
    }
  }
}

改颜色改字号改间距，存个 JSON 就是一套新主题。

封面图生成

公众号发文必须有封面图。如果你手边没有现成的，可以让 Claude Code 帮你生成：

给这篇文章生成封面图

封面图生成用的是 Gemini 的图片生成 API。你需要一个 Gemini API Key，在技能的 config.json 里配置：

{
  "gemini_api_key": "你的Gemini API Key"
}

去 aistudio.google.com 免费申请，有免费额度够用。

没有 Gemini Key 也不影响排版功能，排版和封面是两个独立的技能，排版不依赖任何 API。

常见问题

Q：粘贴到公众号后台样式丢了？

检查你是不是用了"粘贴为纯文本"。微信后台要用普通粘贴（Cmd+V），不能用 Cmd+Shift+V。另外确认是在"正文编辑区"粘贴，不是标题栏。

Q：图片不显示？

本地图片粘贴到公众号后不会自动上传。两种解法：
1. 推送，它会自动上传图片到微信 CDN
2. 手动上传：如果失败，可以在公众号手动上传

Q：报错 No module named 'markdown'？

依赖没装。跑一下 pip3 install markdown requests。如果你用的是 Homebrew 的 Python，可能需要 pip3 install --break-system-packages markdown requests。

Q：打开画廊是空白页？

可能是文件路径有中文或空格。试试把文章复制到一个纯英文路径（比如 /tmp/test.md）再跑。

Q：推送报 40164 错误？

IP 白名单问题。去公众号后台 → 设置与开发 → 基本配置 → IP 白名单，把你当前的公网 IP 加进去。终端跑 curl ifconfig.me 可以看到你的公网 IP。

Q：Windows 能用吗？

Python 脚本跨平台，Windows 上能跑。Claude Code 已经支持 Windows 了（Mac、Linux、Windows）

都支持）

Q：能配合 Obsidian 用吗？

可以，而且这是最佳搭配。在 Obsidian 里写 Markdown，图片用 <span style="color:#999;">[图片: image.jpg]</span> 引用，排版脚本会自动在 Vault 里搜索图片并处理。config.json 里的 vault_root 填你的 Obsidian 仓库根目录就行。

开源地址：https://github.com/xiaohuailabs/xiaohu-wechat-format

装上试一下，排版这件事以后不用再操心了。

有任何问题可以留言我来解答，可能也会有很多bug，可以反馈

或者在群里提问↓

加入XiaoHu.ai 日报社群每天获取最新的AI信息

____________

End.