WeChat Publisher

Write in Obsidian, publish to WeChat Official Account (微信公众号).

WeChat Publisher renders your Markdown notes into WeChat-compatible HTML with proper formatting — code highlighting, math formulas, Mermaid diagrams, local image upload, and one-click draft push to your Official Account. Free for personal use, please don't use it for commercial purposes.

👇 中文文档见下方

在 Obsidian 里写作，一键发布到微信公众号。

WeChat Publisher 是一个 Obsidian 插件，让你在熟悉的写作环境里完成公众号排版，无需离开 Obsidian 就能发布。

个人使用完全免费，全部能力直接解锁，无需激活码。

现在已经可以从 Obsidian 官方社区插件市场安装。打开 Obsidian「设置 → 第三方插件 → 浏览」，搜索 WeChat Publisher 或 wechat，安装并启用即可。

插件页面：https://community.obsidian.md/plugins/wechat-publisher

完整使用教程、截图说明和备用下载方式见：https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

在 Obsidian 官方插件市场搜索 WeChat Publisher

简介

很多人用 Obsidian 写公众号文章，但发布时总绕不开一个麻烦：Markdown 渲染后的样式在微信编辑器里根本不对，代码块、标题、图片全乱，还要手动重排。

WeChat Publisher 解决的就是这个问题。它在 Obsidian 侧边栏直接预览微信排版效果，支持：

格式预览 + 复制 HTML：一键跳转公众号后台粘贴，全程不需要填写任何账号信息
直连公众号 API：配置 AppID/AppSecret 后，直接从 Obsidian 推送到草稿箱，无需打开浏览器

支持的 Markdown 格式：

格式	说明
代码块	语法高亮，保留缩进与空格
数学公式	$...$ 行内 / `$$...$$` 块级，渲染为图片
Mermaid 图表	流程图、时序图等，渲染为图片
表格	完整样式还原
图片	本地 + 远程图片，自动上传微信 CDN
Ruby 注音	`{文字\|注音}` 语法
警示块	`> [!NOTE]` / `[!WARNING]` 等
横向滑图	多图并排轮播

效果预览

以下截图来自真实发布到微信的文章：

代码块语法高亮	数学公式渲染

Mermaid 图表	Ruby 注音

功能

全部能力对个人用户免费开放：

功能	说明
格式预览	Markdown → 微信排版，所见即所发
复制 HTML	一键粘贴到公众号编辑器
跳转公众号平台	一键打开 mp.weixin.qq.com
账号配置 · 直连公众号 API	填入 AppID/AppSecret 后直连
发布到草稿箱	无需打开浏览器，一键推送
封面系统	自动设置封面，支持账号默认封面
多账号切换	同时管理多个公众号

支持的 Markdown 格式

格式	说明
代码块	语法高亮，保留缩进与空格
数学公式	$...$ 行内 / `$$...$$` 块级，渲染为图片
Mermaid 图表	流程图、时序图等，渲染为图片
表格	完整样式还原
图片	本地 + 远程图片，自动上传微信 CDN
Ruby 注音	`{文字\|注音}` 语法
警示块	`> [!NOTE]` / `[!WARNING]` 等
横向滑图	多图并排轮播

使用条款

v1.0.0 起，WeChat Publisher 作为官方市场稳定版，对个人用户完全免费，无需激活码。 全部能力（格式预览、复制 HTML、发布草稿、多账号、封面系统等）直接解锁。

本插件对个人用户完全免费
插件代码以 MIT 许可发布，具体权利以仓库 LICENSE 为准
商业团队如需支持或定制，可通过公众号「HelloRanceLee」联系作者

如果插件对你有帮助，欢迎关注公众号 HelloRanceLee，同步更新 Obsidian 教程、写作技巧与这个插件的最新动态。

安装

方式一：官方社区插件市场（推荐）

WeChat Publisher 已经上架 Obsidian 官方社区插件市场，推荐直接通过市场安装：

打开 Obsidian「设置」。
进入「第三方插件 / Community plugins」。
点击「浏览 / Browse」。
搜索 WeChat Publisher 或 wechat。
点击安装并启用插件。

插件页面：https://community.obsidian.md/plugins/wechat-publisher

完整使用教程、截图说明和常见问题见：https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

方式二：备用安装

如果你暂时无法从官方市场安装，可以使用备用方式：

GitHub Releases：下载 main.js、manifest.json、styles.css，放入 .obsidian/plugins/wechat-publisher/。
BRAT：添加仓库 RanceLee233/wechat-publisher。

备用安装步骤更容易出错，建议优先看完整教程：

https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

使用

打开插件

启用后，点击 Obsidian 左侧边栏的 WeChat Publisher 图标，或按 Cmd/Ctrl+P 搜索 WeChat Publisher 打开预览面板。

插件界面

v0.1.11 起，界面改为单行工具栏 + 可展开抽屉的设计，和 Obsidian 原生风格一致。工具栏从左到右依次为：

区域	说明
元信息卡	封面缩略 + 标题 + 「作者 · 封面状态 · 点击编辑 →」，点击展开抽屉编辑本次发布的标题/作者/封面
账号胶囊	当前账号名 + 状态圆点（绿=已就绪 / 橙=未填写 AppID/AppSecret / 灰=未配置）；点击切换账号
主题/排版胶囊	显示当前主题（如「湖水青」），点击弹出主题/排版速切面板
🔄 刷新渲染 · 📋 复制 HTML	工具图标，悬停显示完整名称
发布草稿	主按钮，一键发布到公众号草稿箱
⋯ 更多	去公众号粘贴、去今日头条发布、滚动同步、隐藏工具栏、账号配置、用户指南、关于 / 联系作者

隐藏工具栏 → 顶部出现「⌄ 显示工具栏」吊签，预览区扩展到全屏。

格式与主题

点击工具栏的主题/排版胶囊，弹出速切面板：

上半：主题风格 —— 13 个内置主题（经典蓝、石墨灰、枫糖棕、薄荷绿、朝阳橙、湖水青、报刊风、森林绿，v0.1.11 新增：极简白 / 编辑部 / 墨卡 / 暖栗色 / 技术流），附简短描述，点击即切换
下半：排版模板 —— 均衡版 / 紧凑版 / 舒展版 / 专栏版，控制字号、行距和留白节奏
底部：高级微调 / 我的方案… —— 打开弹窗做细粒度调整（h1~h4 样式、callout、代码块主题等）或套用保存过的方案

一键切换即刻刷新预览，不会遮挡文章内容。

刷新渲染

插件会在你切换笔记时自动重新渲染预览。如果感觉预览没有及时更新，可点击刷新渲染按钮手动触发。

双向滚动同步

打开工具栏的 ⋯ 菜单，点击「滚动同步」进入同步模式（菜单项右侧显示当前状态：已关闭 / 请先滚动编辑器校准 / 已开启）。

使用步骤：

点击「滚动同步」开启，状态变为"请先滚动编辑器校准"
在左侧编辑器中滚动一次，状态变为"已开启"表示校准完成
之后滚动任意一侧，另一侧自动跟随

同步优先按标题段落对齐，没有标题时按全文比例降级。再次点击「滚动同步」即可关闭。

复制 HTML

点击顶部的复制 HTML 按钮，插件会将当前预览区的渲染结果复制为微信兼容的 HTML。

复制完成后，打开微信公众号后台编辑器，在正文区域直接粘贴即可。适合不需要直连 API、手动上传文章的场景。

去公众号粘贴

点击去公众号粘贴，浏览器会自动打开微信公众号后台 mp.weixin.qq.com，方便你在复制 HTML 后切换到后台粘贴。

去今日头条发布

点击去今日头条发布，浏览器会自动打开今日头条创作者中心的图文发布页 mp.toutiao.com/profile_v4/graphic/publish，方便你在复制 HTML 后切换到头条号后台粘贴。

头条号发布页支持直接粘贴富文本格式，并会自动 ingest 外链图片到自家 CDN。

账号配置

若要一键把文章推送到公众号草稿箱，需要先完成账号配置（填写公众号的 AppID / AppSecret）。

点击顶部操作栏中的账号配置按钮，打开配置弹窗。弹窗顶部以标签页（Tab）形式列出所有已添加的账号，点击标签可切换。

弹窗中各字段说明如下：

字段	说明
账号名称	自定义名称，方便区分多个公众号，例如：主号 / 备用号
AppID	微信公众号的 AppID，在微信公众平台「基础信息」页获取
AppSecret	微信公众号的开发密钥，需在微信公众平台手动启用
IP 白名单辅助	插件自动检测你当前的公网 IP，点击「复制」后去微信平台填入白名单
默认作者	可选。发布资料区没有填写作者时，自动使用此处的名字
默认封面	可选。为该账号设置一张固定封面，每次发文章时自动使用
设为默认账号	开启后，打开插件时自动选中该账号

底部有两个按钮：手动新增账号（填表手动添加）和快速粘贴新建账号（一键从微信公众平台复制内容自动识别）。填写完成后点保存。

账号信息仅保存在本地 Obsidian 配置文件中，不会上传到任何服务器。

快速粘贴新建账号

嫌填表麻烦？有更快的方式：打开微信公众平台「基础信息」页，全选页面内容复制，然后在 WeChat Publisher 账号配置弹窗里点「快速粘贴新建账号」，把内容粘贴进去，插件自动识别账号名、AppID 和 AppSecret，一键完成添加。

快速粘贴新建账号

复制后的内容格式大致如下：

公众号
你的公众号名称
AppID
wx_your_appid_here
AppSecret
your_appsecret_here

如何获取 AppID 和 AppSecret

第一步： 打开微信开发者平台 developers.weixin.qq.com，点击前往控制台。

前往控制台

第二步： 在「我的业务」页面找到你的公众号并点击进入。

找到公众号

第三步： 进入公众号管理后台，在基础信息页面找到 AppID（直接复制）以及开发密钥区域。点击 AppSecret 旁的启用，扫码授权后即可获取 AppSecret。

基础信息页

获取 AppSecret

AppSecret 只会在启用时完整显示一次，请立即复制保存。

如何配置 IP 白名单

微信公众号 API 要求调用接口的服务器 IP 在白名单内。由于 WeChat Publisher 从你的电脑直接调用 API，需要将你的电脑公网 IP 加入白名单。

操作步骤：

在插件的账号配置弹窗中，点击检测本机 IP，插件自动获取你的当前公网 IP
点击复制，复制该 IP 地址
前往微信公众平台「基础信息」页，点击「API IP 白名单」旁的设置名单
将复制的 IP 粘贴进去，多个 IP 用回车隔开，点击确定

如果你在家和公司都会用，两个网络的公网 IP 不同，都要加进去。

发布草稿

完成账号配置后，点击发布草稿。插件自动：

将本地图片上传到微信 CDN
处理 Mermaid 图表、数学公式等为图片
将渲染后的 HTML 连同标题、作者、封面提交到草稿箱

草稿不会直接群发，需在公众号后台手动操作群发。

重复发布会自动更新，不会产生重复文章：如果这篇笔记之前已经发布过草稿，修改后再次点「发布草稿」，插件会自动找到公众号平台上已有的那篇草稿并更新它，不会新建多余的重复文章。

封面系统

封面设置

按钮	说明
从电脑选择封面	从本地选一张图片作为本次文章的封面
清空封面	发布时使用占位空白封面
默认封面	使用账号配置中设定的默认封面

封面优先级：手动选择 > 账号默认封面 > 占位封面。建议尺寸：900×383 px，支持 JPG / PNG。

隐私

不收集任何用户数据：插件完全本地运行，无后台服务器
API 凭证本地存储：AppSecret 仅存储在本地，不上传至任何服务器
图片上传：图片直接上传至微信官方 CDN，不经过第三方服务器
开源审计：插件代码开源，可自行审计

License

MIT

WeChat Publisher

Description

Reviews

Stats

Latest Version

Changelog

README file from