先导出 Markdown,再选择导入方式
用 WeChat to Markdown 保存公众号文章后,可以把导出的 Markdown 文件手工导入思源笔记。这条路径不需要给扩展配置思源 API Token;需要离线图片时,先开启图片下载并完整解压 ZIP,再让思源导入 Markdown 及其本地图片。
商店完整版还提供本机联动:在扩展的本地文章库选中文章,填写思源连接信息,点击“同步所选文章”写入本机思源。这个按钮执行的是你主动发起的一次导入,不代表后台自动同步、双向更新或图片自动上传。单篇免费额度与进阶联动权益见套餐权益页。
方式一:导出文件后手工导入
- 保存需要的公众号文章
从安装页安装扩展,打开你有权阅读的文章,选择 Markdown 导出。需要离线配图时勾选“下载文章图片”,导出正文与图片 ZIP。
- 整理好待导入文件
如果得到的是 ZIP,先完整解压。保留公众号目录内的
.md和_assets/文章稳定标识/的相对位置,不要只把 Markdown 拎到另一个目录。 - 使用思源的 Markdown 导入
在思源桌面端选好目标笔记本,使用 Markdown 导入功能选择导出的文件;整理多篇时,可使用 Markdown 文件夹导入。普通文章 ZIP 需要先解压,不能当作思源的 Data 备份或
.sy.zip原生文档包导入。 - 打开新文档检查
核对标题、正文开头与结尾、来源链接和配图。需要离线使用时,再断网重新打开文档检查图片,确认资源已进入思源,而不只是还能够通过原网络地址显示。
思源官方“导入和导出”指南说明,Markdown 中存在的本地相对路径图片可在导入时转成资源文件;以点开头的隐藏路径不在该处理范围内。图片导入前须确实存在,网络图片下载失败不会由目录结构自动补齐。参见思源官方用户指南中的“导入和导出”。
方式二:从文章库连接本机思源
适合已在本地文章库积累资料,并希望把选中的文章写入指定笔记本的用户。先确认已具备完整版本机联动权益,再用一篇文章验证设置。
- 启动思源桌面端
保持思源运行,并确认目标笔记本可用。准备 API Token 和笔记本 ID;笔记本 ID 是标识符,不是笔记本名称。
- 填写扩展中的思源连接信息
打开本地文章库的思源笔记菜单,填写“地址”“Token”“笔记本 ID”和“目录”。默认地址为
http://127.0.0.1:6806,界面默认目录为/网页文章库。如果本机端口不同,填写实际端口;地址不要带接口路径。 - 选一篇文章并发起导入
先勾选一篇已保存文章,再点击“同步所选文章”。首次连接时,按浏览器提示允许访问所配置的本机地址;完成后读取成功或失败反馈。
- 确认目标文档后再扩大范围
在思源中找到新文档,核对笔记本、目录与正文。确认设置正确后,再从文章库筛选并选择更多文章进行导入。
当前思源官方指南将 API Token 位置列为“设置 → 鉴权 → API token”。若已配置思源命令行,可用 siyuan notebook list 查看笔记本列表并核对 ID;版本与环境相关说明见官方指南中的“剪藏”和“命令行接口”。Token 只填在扩展的连接设置中,不要放入文章正文、截图或反馈消息。
示例:把一篇缓存文章放入资料笔记本
假设选中的文章来自“示例公众号”,标题为“缓存更新实践”,目标笔记本为你自己的“工程资料”,目录设置为 /网页文章库。本机联动会按“设置目录 / 公众号或站点名 / 文章标题”组织文档,目标位置类似:
工程资料(目标笔记本)
└── 网页文章库
└── 示例公众号
└── 缓存更新实践
这是思源里的文档位置示意,不是让你把 Markdown 直接复制到思源工作空间的数据目录。手工导入时,文档位置由你在思源中选择的导入目标决定。
导入成功后,分别核对正文和图片
- 正文:检查标题层级、列表、引用、代码和原文链接,确认没有缺失重要段落。
- 手工导入的图片:本地图片文件应存在且路径正确,导入后检查它们能否作为思源资源离线显示。
- 本机联动的图片:联动直接发送文章库保存的 Markdown,不上传图片文件。文章原有的网络图片仍可能依赖网络;“同步成功”只说明文档写入成功。
- 再次导入:先检查目标文档。本机联动不提供可保证的自动去重、原文更新检测或双向合并,不应通过反复点击来测试内容是否更新。
连接与导入失败时的检查顺序
无法连接思源
先确认桌面端正在运行,再核对本机地址、端口及浏览器授权。扩展目前只接受 http://127.0.0.1 或 http://localhost 的本机服务根地址;远程服务器、局域网 IP 与 HTTPS 地址不在此联动范围内。
提示 Token 或笔记本有误
核对是否使用当前思源工作空间的 API Token,以及目标笔记本的真实 ID。不要把笔记本名字、文档 ID 或网页登录密码填入对应字段。先修正配置,再重试少量文章。
正文已导入,但图片没有离线保存
若走本机联动,这是当前功能边界,可改用带本地图片的 Markdown 手工导入流程。若走手工导入,检查 ZIP 是否完整解压、图片是否下载成功、相对路径是否被移动或重命名破坏。
连接信息只保存在当前浏览器,文章库中的“清除连接”用于清除扩展连接配置,不代表备份或删除思源文档。扩展文章库和思源工作空间是不同的数据副本,重要资料应分别纳入自己的备份方案。
需要先处理图片,查看公众号文章图片打包教程;来源是博客或新闻,查看普通网页转 Markdown;更偏好文件目录式笔记,参考Obsidian 导入流程。识别与连接问题可通过支持页反馈。
这里的完整版联动指官方商店产品,不等同于开源 Community MVP。两者的能力边界见关于产品。导入前的短问答见导入 Obsidian 与思源。