RL RanceLee的博客
← 返回主页

WeChat Publisher — Obsidian 一键发布公众号

⬇️ 下载最新版本 v0.1.15 · 更新于 2026-04-28 · 个人使用完全免费 · 博客只提供最新版，历史版见 GitHub Releases

简介

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

效果预览

以下截图来自真实发布到微信的文章，展示 WeChat Publisher 对各类 Markdown 格式的渲染效果。

代码块（语法高亮）

代码块渲染效果

数学公式 & Mermaid 图表

数学公式渲染效果

Mermaid 图表渲染效果

Ruby 注音

Ruby 注音渲染效果

横向滑图

横向滑图渲染效果

核心能力

能力 说明
🎨 格式预览 Markdown 实时渲染为微信样式，所见即所发
📋 复制 HTML 一键复制渲染后的 HTML，粘贴到公众号编辑器
🚀 一键发布 直接推送到公众号草稿箱，无需打开浏览器
🖼 封面系统 自动从文章图片中设置封面，支持自定义

支持的 Markdown 格式

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

使用条款

v0.1.13 起，WeChat Publisher 对个人用户完全免费，无需激活码。 全部能力（格式预览、复制 HTML、发布草稿、多账号、封面系统等）直接解锁。

  • 本插件对个人用户完全免费
  • 请勿用于商业用途（包括转售、商用培训、二次分发收费等）
  • 如在公司/商业团队使用，请先通过公众号「HelloRanceLee」联系作者获取授权

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

用户指南

WeChat Publisher 是一个 Obsidian 插件，让你在 Obsidian 中写完文章后，直接预览微信排版效果并发布到公众号草稿箱，无需离开 Obsidian。

安装

WeChat Publisher 目前尚未上架 Obsidian 官方插件市场，提供两种安装方式：

方式 适合人群 特点
方式一：BRAT 安装（推荐） 所有用户 自动检测更新，一键升级
方式二：手动安装 熟悉文件操作的用户 无需额外插件

方式一：通过 BRAT 安装（推荐）

BRAT 是 Obsidian 官方市场中的一个插件管理工具，可以直接从 GitHub 安装未上架的插件，并自动管理更新。

第一步：安装 BRAT

在 Obsidian「设置」→「第三方插件」→「浏览」中搜索 BRAT，安装并启用。

BRAT 安装

第二步：添加 WeChat Publisher

打开「设置」→「BRAT」，点击 Add Beta plugin，输入仓库地址：

RanceLee233/wechat-publisher

点击 Add Plugin，选择 Latest version，BRAT 会自动下载安装最新版本。

BRAT 添加插件

BRAT 选择版本

第三步：启用插件

回到「设置」→「第三方插件」，找到 WeChat Publisher，开启开关启用。

后续更新：BRAT 会自动检测新版本。也可以在「设置」→「BRAT」中手动点击 Check for updates 立即检查。

方式二：手动安装

第一步：下载插件

点击上方 ⬇️ 下载最新版本 下载 zip 文件，或前往 GitHub Releases 下载指定历史版本。

第二步：解压到 Obsidian 插件目录

将 zip 解压后，把文件夹复制到 Obsidian 插件目录：

你的仓库路径/.obsidian/plugins/wechat-publisher/

如何找到插件目录？ 在 Obsidian「设置」→「第三方插件」中点击「打开插件文件夹」即可定位。

手动安装目录结构

完成后目录结构应为：

.obsidian/
  plugins/
    wechat-publisher/
      main.js
      manifest.json
      styles.css

第三步：启用插件

打开「设置」→「第三方插件」，找到 WeChat Publisher，点击右侧开关启用。

启用插件

打开插件

启用后，有两种方式打开 WeChat Publisher 面板：

方式一：点击左侧边栏图标

在 Obsidian 左侧边栏找到 WeChat Publisher 图标，点击即可打开预览面板。

打开插件

方式二：使用命令面板

按 Cmd+P（macOS）或 Ctrl+P（Windows），搜索 WeChat Publisher，选择「打开 WeChat Publisher」即可。

界面概览

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

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

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

格式与主题

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

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

一键切换即刻刷新预览，不会遮挡文章内容，方便逐个预览对比。

刷新渲染

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

双向滚动同步

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

使用步骤：

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

同步优先按标题段落对齐（定位到同一标题下的同等进度位置），没有标题时按全文比例降级，比纯比例同步精准得多。

再次点击「滚动同步」即可关闭，两侧恢复独立滚动。

复制 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 加入白名单。

操作步骤：

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

IP 白名单配置

注意： 如果你在不同网络环境下使用（如家里和公司），每个网络的公网 IP 不同，需要分别添加。

发布草稿

完成账号配置后，点击顶部的发布草稿按钮。

插件会自动：

  1. 将文章中的本地图片上传到微信 CDN
  2. 处理 Mermaid 图表、数学公式等为图片
  3. 将渲染后的 HTML 连同标题、作者、封面一起提交到公众号草稿箱

发布成功后，登录微信公众号后台，在草稿箱中即可找到该文章，审阅无误后再群发。

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

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

封面系统

封面设置位于发布资料区，包含三个选项：

封面设置

按钮 说明
从电脑选择封面 打开文件选择器，从本地选一张图片作为本次文章的封面
清空封面 清除当前设置的封面，发布时使用占位空白封面
默认封面 使用账号配置中设定的默认封面（需在账号配置中预先设置）

封面优先级： 手动选择的封面 > 默认封面 > 占位封面（空白）

在账号配置弹窗中也可以管理默认封面：

  • 重新选择默认封面：更换该账号的默认封面图片
  • 清空默认封面：删除已设置的默认封面

封面图片建议尺寸为 900×383 像素（微信公众号推荐比例），格式支持 JPG、PNG。

隐私政策

WeChat Publisher 尊重用户隐私：

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

如有隐私相关问题，请通过博客联系方式联系。