WeChat Publisher
rancelee233316 downloads免费一键将 Obsidian 笔记发布到微信公众号 Publish WeChat Official Account articles with formatting, image upload, and draft push.
- Overview
- Scorecard
- Updates18
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 写公众号文章，但发布时总绕不开一个麻烦：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] 等 |
| 横向滑图 | 多图并排轮播 |
使用条款
v0.1.13 起，WeChat Publisher 对个人用户完全免费，无需激活码。 全部能力（格式预览、复制 HTML、发布草稿、多账号、封面系统等）直接解锁。
- 本插件对个人用户完全免费
- 请勿用于商业用途（包括转售、商用培训、二次分发收费等）
- 如在公司/商业团队使用，请先通过公众号「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 只会在启用时完整显示一次，请立即复制保存。
如何配置 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，不经过第三方服务器
- 开源审计：插件代码开源，可自行审计