wx-layout — 免费离线的公众号模块化排版，Markdown 选主题一键复制进后台

wx-layout 公众号排版工坊是一款免费、离线、可复用的公众号模块化排版工具，以 MIT 协议开源。它用 Markdown 写文章、选定一套主题，一键生成排好版的网页，点「一键复制」粘贴到公众号后台即可，全程不付费、不联网、不依赖第三方服务。项目托管在 GitHub，采用「共享内核 + 可插拔主题」结构，内核只一份，主题可无限增加，属于酷软趣站里的本地写作工具。

场景痛点

写公众号长文，排版常卡在最后一步：正文在编辑器里逐段调字号、配色、间距，换个标题样式又要重做一遍；在线排版工具要联网、存稿到第三方，模板换一套还得重新粘。效率工具自己写 Markdown 再手动改 HTML，层级和引用样式容易错位，复制到公众号后台还会丢格式。写作

主要功能特点

免费离线：只用 Python 标准库，无需 pip install、无需联网；单文件版连 Python 都不需要。
模块化排版：刊头、章节标题、正文、截图、引用、小标题、视频卡片、结尾、作者名片等按模块拼。
多主题：主题放在 themes/，加一套 = 新增一个文件，不改内核、不影响老主题。
内容与样式分离：同一份稿子在不同主题下自动呈现不同形态（纵向 / 横向、含图 / 不含图等）。
微信内部格式输出：生成的是微信认可的 leaf 内部格式，配合一键复制，粘贴干净、不错位。
配套两个 AI Skill：skills/ 内置 wx-layout（把你写好的成稿只做排版、不代写）与 wx-theme-extractor（从任意公众号文章复刻新主题）；可安装到 Agent，也可让任意 AI 直接照《docs/AI 调用指南.md》执行。

四种使用方式，单文件免安装

不想装 Python 的用户直接下载 dist 单文件 HTML（约 80KB），双击浏览器打开，内核、主题、示例全部内联，零依赖、断网可用。在线工具写作者可用命令行 python render.py 文章.md –open 指定主题渲染；工作台.bat 提供三栏预览；纯网页版左侧编辑、右侧实时预览，是轻量软件工具。

Markdown 加模块标记拼版

文章用普通 Markdown 写，按 AI排版手册加模块标记：刊头 issue、章节 part、小标题 sub、截图 shot、引用 quote、视频卡片 video、结尾 end、作者名片 author。Markdown part、sub、shot、quote、video 可多次使用，issue、author、end 每篇各一次，字段缺失自动降级，不会报错留白。

共享内核与可插拔主题

内核只维护一份 wx_core.py，负责解析、微信适配和复制；主题放在 themes/，加一套就是新增一个 .py 文件，不改内核、不影响老主题。开源软件内置蓝白杂志、暖橙横向、暖棕手记、翠绿科技四套主题，同一模块在不同主题里形态不同，卡片在纵向主题里是封面图加标题按钮，横向主题里只有标题摘要。

微信认可格式与一键复制

生成的是微信认可的内部格式，配合一键复制，粘贴到公众号后台干净、不错位。内容创作外链图片可能被公众号拦截，稳妥做法是先在后台上传、复制 mmbiz.qpic.cn 地址；视频需先传素材库，用 video 模块渲染成卡片，发布时光标放进视频位再插入；图片不支持本地路径，必须先上传后台、走素材地址。宝藏资料

两个 AI Skill，只排版不代写

仓库自带两个 Skill：wx-layout 排版器把成稿只做排版、不代写，读取主题契约后只加模块标记再调 render.py；wx-theme-extractor 从公众号文章保存页抽取 DOM 和样式，归纳出新主题。AI应用复制安装话术发给 Agent 即可自动装好并验证；不安装也能把通用排版规则连同成稿发给任意 AI，AI 只加标记、程序精确渲染。

内容与样式分离

作者写「语义 + 全量字段」，主题按需取用，同一份稿子在不同主题下自动呈现不同形态，纵向或横向、含图或不含图都由主题决定。AI工具没给公众号名称时，排版结果会写「【请改成你的公众号名称】」占位并提醒替换，不会替作者编名称，排版结果与原稿逐字对应，不替作者改写一个句子，适合自媒体写作者在本地使用。

贡献主题与打包分享

新增主题在 themes/ 加 .py、在 web/themes/ 加对应 JS，用示例验证后跑 web_parity 保证 Python 与 JS 两端渲染一致。工具推荐双击打包单文件.bat 可重新生成分发用的 HTML，把这一个文件发给他人即可双击用；也能部署到免费静态托管得到在线网址。实用软件

官方网站

GitHub https://github.com/fengdu2077/wx-layout

下载地址

https://pan.quark.cn/s/e116091c2774

wx-layout — 免费离线的公众号模块化排版，Markdown 选主题一键复制进后台

场景痛点