Dou Publish for WeChat

An Obsidian desktop plugin that previews Markdown using a WeChat-friendly theme and copies rich text, including local article images, into the WeChat Official Account editor. Open a Markdown note, preview it from the ribbon, choose Copy to WeChat, and paste into the editor. No WeChat API credentials are required for copying.

Previewing and copying stay local. Local images are embedded into the rich-text clipboard and are not uploaded by the plugin.

一款桌面端 Obsidian 插件，用统一的公众号样式预览 Markdown，并把带格式正文和本地配图一键复制到微信公众号编辑器。

功能

• 在 Obsidian 侧栏预览公众号排版
• 支持 Markdown 图片与 Obsidian 图片嵌入 ![[image.png]]
• 保留 ![[image.png|400]] 与 ![说明|400](image.png) 中设置的图片宽度
• 一键复制行内样式和正文图片，粘贴到微信公众号编辑器
• 自动把较大的静态图片压缩为适合公众号粘贴的 JPEG
• 复制前检查图片数量、体积和无法读取的图片
• 支持包含 10 张以上图片的长文预览与复制，不会混淆图片位置
• 将任务列表转换为公众号可稳定显示的 ☐ 与 ☑
• 可调整主题色、正文字号、行高、段落间距、引用样式、代码行号和图片圆角
• 无需公众号 AppID、AppSecret 或 IP 白名单
• 不创建草稿，不自动发布文章

安装

使用 Release 安装

下载 Release 中的 ZIP，解压到仓库的 .obsidian/plugins/dou-publish-preview/。目录内至少应有：

main.js
manifest.json
styles.css

重启 Obsidian，在“设置 → 第三方插件”中启用 Dou Publish for WeChat。

使用源码安装

Obsidian 不能直接运行 src/*.ts，需要先把源码编译成 main.js：

git clone https://github.com/miracle0828/dou-publish-for-wechat.git dou-publish-preview
cd dou-publish-preview
npm install
npm run build

编译完成后有两种安装方式：

1. 如果源码就放在仓库的 .obsidian/plugins/dou-publish-preview/，直接重启 Obsidian 并启用插件。
2. 如果源码放在其他目录，把生成的 main.js、manifest.json、styles.css 复制到 .obsidian/plugins/dou-publish-preview/，然后重启 Obsidian。

运行源码与构建插件需要 Node.js 18 或更高版本；普通使用者安装 Release 不需要 Node.js。

使用

1. 打开 Markdown 文章。
2. 点击左侧报纸图标，检查右侧预览。
3. 点击“复制到公众号”。插件会把本地图片转换为剪贴板图片数据，无需配置公众号接口。
4. 到公众号正文编辑区按 Ctrl+V。标题与封面仍在公众号后台单独填写。

如需调整排版，打开“设置 → Dou Publish for WeChat”。设置会同时作用于侧栏预览和复制后的公众号正文，也可以随时恢复默认排版。

外链图片不会被插件自动下载，请先保存到 Obsidian 仓库。GIF 超过 10 MB 时仍可复制，但粘贴可能较慢。

隐私与安全

• 预览在本机完成，不上传正文。
• 点击“复制到公众号”时，本地图片会转换为 Base64 图片并写入系统富文本剪贴板。
• 插件不需要公众号凭据，不调用微信 API，也不会把文章或图片发送到开发者服务器。
• 预览使用受限 iframe；复制前会移除脚本、嵌入对象、事件属性和不安全链接。

开发

需要 Node.js 18 或更高版本。

npm install
npm test
npm run build
npm run package

排版引擎使用开源包 baoyu-md。零配置图片复制流程参考了 Wechat Converter 的“本地图片转 Data URL 后写入富文本剪贴板”方案，未复制其源码。