Zotero Better Notes插件同步功能使用指南

问题现象分析

在使用Zotero Better Notes插件时，部分用户可能会遇到导出的笔记无法被同步管理器识别的问题。具体表现为：

1. 通过"系统导出"方式导出的Markdown笔记
2. 同步管理器无法检测到新导出的笔记
3. 笔记标题缺少应有的同步标识码
4. 虽然笔记已出现在Obsidian中，但无法建立双向同步

核心问题定位

经过分析，问题的根本原因在于导出方式选择不当。当用户勾选"使用系统导出"选项时，插件无法为导出的笔记添加必要的同步元数据，导致同步功能失效。

正确操作方案

1. 直接导出方式：

   • 在导出对话框出现时，直接点击"确定"按钮
   • 避免勾选"使用系统导出"选项

2. 推荐导出设置：

   • 勾选"将链接笔记转换为独立导出"
   • 启用"设置自动同步"选项
   • 这样可以直接建立同步关系，无需后续手动检测

技术原理说明

Zotero Better Notes的同步功能依赖于特定的元数据标识：

1. 正常导出时，插件会自动在笔记文件中添加同步标识码
2. 这些标识码包含在YAML frontmatter中
3. 同步管理器通过扫描这些标识码来建立关联
4. "系统导出"方式会绕过插件的元数据处理流程

最佳实践建议

1. 始终通过插件的原生导出功能进行操作
2. 首次导出时即设置自动同步
3. 保持Zotero和插件为最新版本
4. 如遇同步问题，可尝试重新导出笔记

注意事项

1. 导出的Markdown文件应保持原样，不要手动修改元数据部分
2. 确保Obsidian vault目录有正确的读写权限
3. 避免在多个位置重复导出同一笔记

通过遵循以上指南，用户可以确保Zotero Better Notes的同步功能正常工作，实现Zotero与Obsidian之间的无缝笔记同步体验。