📖 导读摘要这不是一个替你写文章的工具，而是一个把你已经写好的 Obsidian Markdown 文章，连同图片、排版和预览，一键无缝送进微信公众号草稿箱的本地插件。

⏳ 本篇字数：约 2258 字 | ⏳ 预计阅读：约 6 分钟

我为什么做这个插件

我以前一直觉得，写公众号最难的是选题和表达。

后来真正高频写起来才发现，最消耗人的，往往不是写作本身，而是写完之后那一串重复动作。

一篇文章在 Obsidian 里已经写好了，图片也配好了，但真正要发到公众号时，还要复制到排版工具，重新调整标题、加粗、引用和分隔线，再处理图片、检查手机端效果，最后复制进微信公众号后台，再看一遍有没有格式乱掉。

如果文章里有多张图，这个过程会更麻烦。

我只是想解决一个很具体的问题：

我已经在 Obsidian 里把文章写好了，能不能不要再搬来搬去了？

于是，我做了这个插件：Obsidian WeChat Publisher。

它的目标很简单：

不是替你写公众号，而是把你已经写好的 Obsidian 文章，尽量顺滑地送进微信公众号草稿箱。

（实际效果图）

我原来卡在哪一步

每次把本地排版好的 Markdown 拷到微信后台，格式就开始乱。

一句话在电脑上看不长，到了手机上可能就变成了一整屏。

一个列表嵌套在 Obsidian 里很正常，到了微信里可能就会冒出多余的空行和小黑点。

一个代码块的溢出样式可能直接无法识别。

一个表格在手机屏幕上可能就直接爆掉。

这些不是写作问题。

这是工具衔接问题。

最头疼的还是插图。

如果文章里配了十多张图，我需要在微信后台的正文里挨个找位置，逐个上传。

每次发文都要重复这套动作。

这种极其割裂、低效的重复劳动极易打破内容生产的心流。

我试过哪些方案，为什么没继续用

为了解决这些问题，我也找过很多工具。

找到的，基本都卡在这几道关卡上：

有的已经停更了，配合新版 API 直接跑不起来。

有的文字同步免费，但图片同步要收费。

还有一种，要求把 AppID 和 AppSecret 上传到他们的云端服务器。

我非常介意密钥脱离本地环境。

一旦第三方服务器发生泄露，公众号接口调用权限就可能暴露在额外风险中。

所以最后，我决定自己写一个。

这个插件具体解决什么

Obsidian WeChat Publisher 是一个本地 Obsidian 插件。

它的定位很清楚：

在这个过程里，它在后台帮你处理格式兼容的脏活。

它怎么使用

配置完成后，日常同步发文只需经过以下几个简单步骤：

1.本地写作配图：在 Obsidian 中照常使用 Markdown 正常写作与贴图，或在 YAML 头部的 cover 字段指定封面图。

2.手机效果预览：快捷键 Command + P 唤出命令面板，选择预览当前笔记的微信排版效果。

3.一键模板换肤：在双栏的手机预览模拟框中自由换用极细线框风、现代左竖风或商务色块风等主题，也可以通过 Hex 取色器来自定义调整正文字体大小和品牌主色调。

4.一键同步草稿：在预览中对排版表示满意后，点击"同步到微信草稿箱"按钮，插件便会自动直连并生成公众号草稿。

完成这些之后，你的文章就会出现在微信公众号草稿箱里，等待你最后确认和发布。

安全边界怎么处理

安全隐私是不可妥协的底线，因此这款插件设计为纯本地直连架构，不设置且绝不通过任何中间商服务器。

你的敏感 AppID 和 AppSecret 仅仅被保存在你本地电脑 Vault 插件配置目录下的 data.json 中。在本地它虽然是明文存储，但只需由用户妥善保管好本地设备、云同步目录及插件配置文件即可。

插件通过 Node.js 原生的 https 模块，直接与微信官方 API 服务器（api.weixin.qq.com）通信。这种设计减少了第三方云端中转带来的密钥暴露风险，所有数据交互、图片直连上传都在本地运行环境闭环完成。

但这里也要客观说边界：本地保存不是万能安全。你仍然需要保护好自己的 Obsidian Vault、电脑账户和插件配置文件，防止被恶意软件读取。我不建议把这个插件理解成"用了就百分之百安全"，更准确地说，它做的是：尽量减少第三方中转，把账号配置和文章处理留在你的本地环境里。

它现在不解决什么

作为一款开源效率插件，它并不是全能的，仍有以下已知局限：

•配置门槛：首次使用必须在微信后台配置开发者凭证，且需要将当前的公网 IP 地址加入到微信的白名单中。由于许多家庭和办公网络公网 IP 会动态变动，IP 变化后直连会失败，用户需要去后台更新白名单。

•非增量同步：目前不支持增量图片指纹，每次同步即使图片没修改也会重新上传所有配图。

•多媒体局限：仅支持图文与插图同步，不支持视频、音频等富媒体文件的自动插入。

•开源维护边界：开源不等于能承诺即时响应所有问题。免费开源工具很难承诺实时支持，也不能保证适配所有环境。使用前，建议先备份你的文章和配置。

因此，这个插件最不适合不用 Obsidian 写作、不习惯 Markdown 语法、或者对微信公众平台后台 IP 白名单配置感到困难的写作者。

如果你也有类似需求，可以去试试

这款插件已经完全开源，且供全社区公益免费使用。如果您也喜欢用 Obsidian 进行深度创作，可以在 GitHub 上下载并 Star 关注。

•开源仓库：请关注公众号后在后台回复“排版神器”领取。

•提交 Bug / 需求：若遇到同步报错或格式解析问题，可在 GitHub Issue 页面提交你的配置环境与调试日志。

日常我也在公众号分享关于法律 AI、自媒体创作以及数字化效率工具的实践，欢迎关注或添加个人微信进行交流。

法律类文章不构成个案法律意见。