Obsidian Memos Sync 是一款旨在连接 Memos (一款轻量级、自托管的碎片化知识管理工具) 与 Obsidian 的插件。
它可以一键将你在 Memos 中记录的当天的碎片化想法、日记和图片,按照你喜欢的格式同步到 Obsidian 的 Daily Note (日记) 中。
-
一键同步:快速获取当天的 Memos 记录。
-
去重更新 (Block Mode):采用标记区块 (
<!-- Memos Start -->) 方式写入。多次点击同步只会更新内容,不会导致内容重复堆叠。 -
高度可定制模板:支持自定义标题和每条 Memo 的格式,提供丰富的时间和元数据变量。
-
图片鉴权修复:自动为 Memos 的私有图片链接追加 Token,解决 Obsidian 中图片无法加载 (403 Forbidden) 的问题。
-
独立运行:不依赖第三方日记插件,直接配置路径和日期格式即可精准定位目标文件。
-
广泛兼容:兼容 Memos 新旧版本 API (v0.1x - v0.22+)。
-
下载本插件的 Release 版本(
main.js,manifest.json,styles.css)。 -
在你的 Obsidian 仓库中,进入
.obsidian/plugins/目录。 -
新建文件夹
obsidian-memos-sync。 -
将下载的文件放入该文件夹。
-
重启 Obsidian,在“第三方插件”中启用 Memos Sync。
如果你安装了 Obsidian42 - BRAT 插件:
-
打开 BRAT 设置。
-
点击 "Add Beta plugin"。
-
输入本仓库的 GitHub 地址。
-
点击 "Add Plugin"。
启用插件后,请在设置页面进行如下配置:
-
Memos Host URL: 你的 Memos 服务器地址。
- 示例:
https://memos.example.com(末尾无需/api/v1)
- 示例:
-
Access Token: 在 Memos 网页端 -> 设置 -> 个人 -> Access Token 中获取。
无需安装 Daily Notes Interface,直接指定路径:
-
Daily Note 存放路径: 日记文件所在的文件夹路径。
- 示例:
Journal/2024或Daily。如果放在根目录,请留空或填/。
- 示例:
-
Daily Note 日期格式: 对应文件名的日期格式 (Moment.js 语法)。
- 示例:
YYYY-MM-DD(对应2024-05-20.md)
- 示例:
-
插入模式 (Insert Mode):
-
Block Mode (推荐): 在文档末尾创建固定区域进行同步,支持反复更新。
-
Cursor Mode: 仅在当前光标位置粘贴文本,不做去重处理。
-
你可以使用以下变量自定义 内容模板:
| 变量 | 描述 | 示例 |
|---|---|---|
{{time}} |
笔记创建时间 (HH:mm) | 14:30 |
{{date}} |
笔记创建日期 (YYYY-MM-DD) | 2024-05-20 |
{{datetime}} |
完整时间 | 2024-05-20 14:30:00 |
{{content}} |
笔记正文内容 | 今天天气不错... |
{{id}} |
Memo ID | 1024 |
{{creator}} |
创建者用户名 | admin |
{{status}} |
笔记状态 | NORMAL |
推荐模板示例:
- `{{time}}` {{content}} [Memos Link](https://memos.example.com/m/{{id}})
-
打开你需要同步的那一天的 Daily Note(或者确保该文件已存在)。
-
点击左侧边栏的 "Sync Memos" 图标(刷新图标)。
-
或者使用命令面板 (Ctrl/Cmd + P),输入
Sync today's memos。 -
插件会自动拉取数据并写入文档。
Q: 同步时提示 "Invalid date"? A: 这是因为部分新版 Memos API 返回的时间字段格式发生了变化。插件 v1.0.0 已修复此问题,自动兼容 Unix 时间戳和 ISO 时间字符串。
Q: 图片显示裂图或 403 Forbidden? A: Memos 的图片通常需要登录才能访问。本插件会自动识别图片链接并在末尾追加 ?token=YOUR_TOKEN,让 Obsidian 可以直接渲染私有图片。请确保 Access Token 正确。
Q: 为什么不同步已归档 (Archived) 的记录? A: 插件默认过滤掉了 row_status != "NORMAL" 的记录,只同步正常的笔记。
Q: 如果当天的日记文件不存在怎么办? A: 插件会弹窗提示“目标 Daily Note 不存在”。请先在 Obsidian 中创建当天的日记文件(或使用日记插件创建),然后再点击同步。
MIT License.