NoteToMP（1.0.6）——Obsidian一键发公众号插件使用指南
本指南更新于2024年7月9日，适应于版本1.0.6 。
插件功能还在不停更新中，使用指南也会随时调整，可以及关注公众号获取最新信息
1、功能简介
NoteToMP是一款Obsidian插件，它可以直接将Obsidian中的笔记发布到公众号，还能为笔记设置不同的样式（自带30多款样式，完全免费），不用再去公众号的编辑器里重新排版了，可以大大节省时间。NoteToMP还有以下多个亮点：
支持一键直发草稿
支持本地图片上传
支持多公众号切换
支持文章背景（选取带有背景的主题）
支持公众号链接点击及其它链接的展示
支持代码高亮
支持代码行号
将要支持数学公式（近期上线）
NoteToMP目前不能独立使用，需要配合Obsidian才能用。Obsidian是一款免费的跨平台笔记软件，它因其强大的双链功能和灵活的插件系统而备受用户喜爱。无论是日常笔记、学术研究还是知识管理，Obsidian 都能提供高效且便捷的解决方案。如果您还不熟悉Obsidian也不要紧，只要花一个多小时，看一下B站清单控沙牛大佬的教程[https://www.bilibili.com/video/BV1H44y1n71k/]即可轻松上手，看完前三个视频就足以上手了，后面可以再慢慢看。
NoteToMP插件的部分功能是需要订阅才能使用，如一键直发草稿，本地图片上传，数学公式等。这些功能是需要用到微信公众号提供的开放API，但由于微信公众号的限制[https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html]，API调用过程中需要用的鉴权Token必须由固定IP获取，并且该IP需要加入IP白名单，因此上传图片素材、发布草稿等功能需要配合服务端完成。订阅费用主要用来支付服务器购买及维护、支持等项目。
另外NoteToMP插件是开源的，源码地址：https://github.com/sunbooshi/note-to-mp ，开源并不意味着免费，我开源的目的是想告诉用户，代码在这里，你可以来看看我没有瞎搞，没有乱拿用户数据。
其实对大部分用户而言，只是偶尔写一下公众号，也不介意花一点时间自己上传本地图片，那你完全不需要花钱订阅。
Warning在订阅之前请先确认是否已获取相关接口调用权限
登录微信公众平台 https://mp.weixin.qq.com/ 通过设置与开发——接口权限，检查是否有获取access_token、永久素材管理接口的权限。
如果没有相关接口权限，就无需付费订阅，因为无法使用插件的上传图片和发草稿功能，
需要您手动复制到公众号编辑器。
2、安装
首先，请确认已关闭了Obsidian的安全模式。如未关闭，请通过设置——第三方插件——关闭安全模式关闭。
2.1 插件安装
1）从官方社区插件市场安装（推荐安装方式）
通过Obsidian设置——第三方插件——社区插件市场，输入Note to MP、Wechat或者booshi搜索安装。
2）从网盘下载安装
下载链接: https://pan.baidu.com/s/1ij_rpXHqP-Am8uomFunNnQ?pwd=qy89 提取码: qy89
下载其中的note-to-mp-xxxx.zip，解压后，将其中的note-to-mp目录拖到.obsidian/plugins目录下。
打开Obsidian的设置界面，点击第三方插件，在已安装插件中刷新一下，然后启用本插件Note To MP。
3）从Github下载安装
到Release[https://github.com/sunbooshi/note-to-mp/releases]页面下载最新版本，将main.js、 manifest.json、styles.css保存到Obsidian仓库的.obsidian/plugins/note-to-mp目录下。
打开Obsidian的设置界面，点击第三方插件，在已安装插件中刷新一下，然后启用本插件Note To MP。
4）使用BRAT插件安装
对于网络较好的用户，推荐使用BRAT插件[https://github.com/TfTHacker/obsidian42-brat]安装。
打开Obsidian的设置界面，在底部的第三方插件——BRAT——点击Add Beta plugin，然后输入本插件地址https://github.com/sunbooshi/note-to-mp，点击Add Plugin就可以安装本插件了。
2.2 主题资源安装
如果采用的是用从Github下载安装和使用BRAT插件安装的方式，在插件安装完成后还需要再下载主题资源。网盘里的安装包已经集成了主题样式，无需下载。
1）通过设置下载（推荐安装方式）
为了尽可能保证插件符合官方规范，主题和代码高亮需要打开Obsidian的设置界面，在底部的第三方插件——Note to MP——获取更多主题手动下载。
2）手动下载
也可以直接在Release[https://github.com/sunbooshi/note-to-mp/releases]页面下载assets.zip文件，解压后放到.obsidian/plugins/note-to-mp/assets目录下。
2.3 常见安装问题
插件的目录名一定要是note-to-mp，出现安装问题时请先检查目录名是否正确。
1）插件无法启动
检查一下你安装的插件路径是否正确，插件目录名及目录内容应如下所示：
.obsidian/plugins/note-to-mp/
├── main.js
├── manifest.json
└── styles.css
2）只有默认主题
确认根据2.2 主题资源安装里的步骤操作了，然后检查一下插件目录内容，应如下所示：
.obsidian/plugins/note-to-mp/
├── assets
│ ├── themes.json
│ ├── highlights.json
│ ├── themes
│ │ ├── maple.css
│ │ ├── mweb-ayu.css
│ │ └── ...
│ └── highlights
│ ├── a11y-dark.css
│ ├── a11y-light.css
│ └── ...
├── main.js
├── manifest.json
└── styles.css
3、插件配置
如果希望通过插件上传图片到公众号，或者直接发草稿，还需要对插件进行配置。
3.1 微信公众号设置
登录微信公众平台 https://mp.weixin.qq.com/
1）获取开发者ID（AppID）和开发者密码（AppSecret）
⚠️AppID现在是严格大小写匹配，请务必仔细检查，另外目前AppID基本都是wx开头的，也可以作为检查的依据。
通过设置与开发——基本配置——公众号开发信息获取
2）设置IP白名单
通过设置与开发——基本配置——公众号开发信息——IP白名单，添加如下IP地址：
59.110.112.211
154.8.198.218
3.2 提交试用申请
目前订阅服务免费，可以通过填写问卷申请。在问卷中填写您的邮箱、微信公众号的开发者ID（AppID），申请通过后会给您发送邮件。
https://f1b9139iu4h.feishu.cn/share/base/form/shrcnak7ybJHCXr5nIq0rM7UOmH
3.3 填写公众号信息
当接收到申请通过邮件后，将邮件中的注册码，填写到“Obsidian设置——Note to MP——注册码（AuthKey）”
将公众号信息按以下格式填入“Obsidian设置——Note to MP——公众号信息”，不同字段用 “|” 分割，不要包含空格：
公众号名称|AppID|AppSecret
每个公众号一行，如：
孙博士研究所|wx88888888|abcdef0011223344
孙博士研究所2|wx9999999|abcdef0011223344
然后点击加密公众号信息即可将公众号信息加密保存到本地。
如果需要更改公众号信息，请先清空，再重新填写并且加密。
4、插件使用
点击Obsidian左侧工具栏中的图标
或者按Ctrl+P打开命令，搜索复制到公众号，即可在侧边栏展示当前笔记预览。
★ 公众号
插件支持多公众号，在下拉菜单中进行不同公众号的切换。该功能需要订阅才能使用。
★ 复制
检查样式无误后，点击复制按钮，然后到公众号编辑器粘贴即可。
★ 上传图片
点击上传图片会将文章中的本地图片上传到微信公众号，同时会替换预览中的图片地址，而您原始文章中的图片地址不会替换。上传图片完成之后，此时点击“复制”，然后到微信公众号编缉器中粘贴就可以把图片带过去了。该功能需要订阅才能使用。
★ 发草稿
点击发草稿会上传文章中的本地图片，并且将文章发送到公众号的草稿箱，省去粘贴步骤。在文章正式发布之前还有一些选项需要您设置，比如文章摘要等。考虑到安全性，插件暂不提供直接发布功能。该功能需要订阅才能使用。
★ 刷新
如果笔记内容更新了，但是预览没有更新，可以点击一下刷新按钮。
★ 封面
发草稿必须设置文章封面，使用默认封面，是从您的永久素材中选取最近使用的作为封面，您需要在发布文章之前重新设置一下。本地上传则需要你选取一张本地图片作为封面。
★ 样式
可以选取笔记的样式，目前有30多款，还在持续增加中。如果有钟意的样式，可以在插件设置中，设置为默认样式，这样就不用每次都点一下了。
★ 代码高亮
设置代码高亮的样式。
5、反馈交流群
QQ群2: 980865715
微信群：
或者加客服微信：Genius35Plus，拉您进群：
6、隐私政策
如果您不使用订阅服务，那NoteToMP插件不会使用您的任何个人信息。如果您使用订阅服务，则表示您同意收集和使用与本隐私政策有关的信息。
信息收集和使用
则NoteToMP会收集并存储您的邮箱，公众号的开发者ID（AppID）。其中邮箱由于接收注册码及其他服务信息，并不会用作其它用途。开发者ID（AppID）用于区分不同的公众号。
在订阅服务中也会用到微信公众号的开发者密码（AppSecret）但该信息会加密存储到本地（也就是您自己的设备），在订阅服务中仅会透穿到微信的服务器，订阅服务本身不会存储、记录您的开发者密码（AppSecret），所以需要您自己妥善保管，避免泄漏。
安全
我们非常重视信息安全，但没有任何互联网传输方法或电子存储方法是100%安全可靠的，我们不能保证其绝对安全。下面是一些可能带来风险的信息，请务必重视：
注册码（AuthKey）是订阅服务区分您身份及权限的唯一信息，请务必妥善存储不要透露给他人，如果发生泄漏请立刻联系我们重新生成。
开发者密码（AppSecret）是由插件加密保存在本地，即使加密后的数据泄漏，其他人也无法解密使用。
所以如果您存储了原始的开发者密码（AppSecret）请务必保证安全，一旦泄漏请前往微信公众平台进行重置。
重置完成，请重新填写公众号信息并加密。
7、代码审查服务
插件代码完全开放，可在GitHub[https://github.com/sunbooshi/note-to-mp]查看，但订阅服务相关代码未开放，为了让大家用的更放心，特提供代码审查服务，每次200元。设置付费的目的是提高门槛，阻止一些别有用心的人。
8、私有部署
如果您对本服务不放心，但仍想使用插件提供的上传素材、发草稿等功能，可以采用私有部署，暂定每年600元的费用，需要自己提供服务器。私有部署的详细内容及服务内容需要沟通确定。
加群交流如果在使用和学习中有不明白的地方，或者想看看别人的经验，可以加入QQ群：980865715
Tip如您在安装、使用过程中有任何问题，或者有任何建议，或者发现了Bug可以加群反馈，也可以直接添加作者微信：Genius35Plus ，QQ：2408822130 反馈。