Shuai WeChat Formatter

English

在 Obsidian 写完 markdown 之后，点击插件，一键复制，直接粘贴到微信公众号，带排版样式的文章就都过去了。

选主题配色，调字体、行距和页边距，添加刊头与结尾钩子，实时预览公众号效果。

视频讲解

▶ 在 B 站观看：从开发到上架，我把整个 Obsidian 插件都交给了 Codex

功能亮点

• 一键复制，直接粘贴：将当前 Markdown 笔记复制为公众号富文本，保留预览中的排版。
• 经典、极简、新锐、杂志、shuai 五套主题风格，可选择主题配色。shuai 以黑白排版、衬线标题和朱砂红点缀延续个人网站风格，配色选择「跟随主题」即可使用。
• 调整正文字体、行间距和左右页边距，在 Obsidian 中实时预览。
• 可添加带品牌名和徽章的开头刊头，以及 Markdown 格式的结尾钩子。
• 自动将正文外链整理为文末编号引用。
• 全程本地处理，不上传笔记，不发送网络请求，也不收集数据。

使用方法

1. 在 Obsidian 中打开一篇 Markdown 笔记。
2. 点击左侧 Ribbon 中的“帅”字按钮，自动复制公众号格式并打开预览。
3. 进入微信公众号编辑器，直接粘贴。

如需调整排版，在预览页选择主题配色、调整字体与间距，按需开启刊头与结尾钩子，再点击顶部的「复制公众号格式」后粘贴。

安装

在 Obsidian 中打开：

设置 → 第三方插件 → 浏览 → 搜索 Shuai WeChat Formatter

安装并启用即可。

查看 Obsidian 社区插件页面。

也可以从最新的 GitHub Release 下载 main.js、manifest.json 和 styles.css，放入：

<你的仓库>/.obsidian/plugins/shuai-wechat-formatter/

重启 Obsidian，然后在「设置 → 第三方插件」中启用。

排版设置

打开「设置 → Shuai WeChat Formatter」，可以配置：

• 「预览」：选择右侧分栏或新标签页。
• 「默认排版」：设置正文字体、五套主题风格、配色方案、行间距和页边距。
• 「开头与品牌」：设置品牌名、刊头样式和徽章文字。
• 「结尾内容」：管理需要追加到文章末尾的 Markdown 结尾钩子。

预览页中的临时调整会影响下一次复制，但不会覆盖默认设置。

支持的 Markdown

图片处理

本插件不提供图片上传和存储。文章中的图片需要使用可公开访问的网络链接；插件会保留这些链接，但不会自动处理 Obsidian 的 ![[本地图片]]。

我自己的方案是 Image Auto Upload Plugin 配合 PicGo：

1. 在 PicGo 中配置自己的图床。
2. 使用 Image Auto Upload Plugin 自动上传本地图片。
3. 图片上传后，笔记中的本地引用会替换为网络链接。
4. 再使用本插件复制公众号格式。

Image Auto Upload Plugin 和 PicGo 负责图片上传，本插件只负责排版和复制。它们是推荐搭配，不是本插件的强制依赖。

链接与引用源

微信公众号编辑器无法稳定保留普通外链。插件会在链接原位置添加编号，并把网址集中到文章最后：

查看 [Obsidian](https://obsidian.md)

转换后类似：

查看 Obsidian[1]

引用源
[1] Obsidian
    https://obsidian.md

隐私

插件不发送网络请求，不收集数据，也不保存文章副本。笔记内容只在当前 Obsidian 窗口中转换，并在点击复制时写入系统剪贴板。

已知限制

• 当前没有针对 Obsidian 移动端做完整实机验证。
• 微信公众号可能继续过滤部分 HTML 或样式，发布前请检查粘贴结果。

用户好评

我装上了很方便

一位用户安装后的反馈：

联系作者

我是王帅真，欢迎扫码添加我的微信，交流插件使用体验、反馈问题或建议。

支持作者

如果这个插件帮你省下了一点排版时间，欢迎请我喝杯豆浆 ☕️

本地开发

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

git clone [email protected]:qizong007/shuai-ob-wx-offi-plugin.git
cd shuai-ob-wx-offi-plugin
npm install
npm test
npm run build

欢迎提交 Issue 或 Pull Request。涉及微信公众号样式兼容性的修改，请同时提供 Obsidian 预览和微信公众号编辑器粘贴结果。

License

MIT