argenos/zotero-mdnotes · 上手攻略
- 仓库：argenos/zotero-mdnotes
- 链接：https://github.com/argenos/zotero-mdnotes
- 分类：学术工具 · Zotero 插件
- 作者：Tom
- 更新：2026-08-22
是什么
argenos/zotero-mdnotes 是一款 Zotero 5 的插件（plugin），用于将文献条目的元数据及其笔记导出为 Markdown 文件，从而支持用户在 Obsidian、Logseq 等双链笔记工具中直接引用 Zotero 文献库。导出内容包括：题名、作者、期刊、年份、DOI、摘要等标准引用字段，以及 Zotero 内部笔记（notes）的内容。插件通过右键菜单提供单条导出和批量导出两种操作方式，文件名由命名模板自动生成。
⚠️ 重要：该插件已停止维护，不兼容 Zotero 7。作者在 README 中明确建议 Zotero 7 用户改用 obsidian-zotero-integration。
解决什么问题
学术写作者在 Zotero 中管理文献，但在纯 Markdown 工作流（Obsidian/Logseq）中引用时，需要手动复制条目信息。zotero-mdnotes 自动化了这个桥接过程：
- 文献元数据 → Markdown：每篇文献自动生成一个
.md文件，包含完整引用字段 - Zotero 笔记 → Markdown：Zotero 内的笔记内容一并导出，保留与文献的关联
- 批量导出整个文献库：无需逐条操作，一次性将所有文献转为 Markdown 文件树
- 命名模板可配置：文件名格式可按期刊、作者、年份等变量自定义
快速安装
环境要求
- Zotero v5.x（不支持 Zotero 7）
- 推荐同时安装：Zotfile + BetterBibTeX（插件作者未在无这两个插件的环境下测试）
- 操作系统：Ubuntu 18.04 亲测，macOS/Windows 理论上可用
安装步骤
- 前往 GitHub Releases 页面 下载最新的
.xpi文件 - 打开 Zotero → 菜单栏
Tools→Add-Ons - 将下载的
.xpi文件拖入 Add-Ons 窗口 - 安装完成后重启 Zotero
# 手动安装方式（备选）：将 .xpi 重命名为 .zip，解压到 Zotero 插件目录
# 一般路径：
# macOS: ~/Library/Zotero/Profiles/<随机>.default/extensions/
# Windows: %APPDATA%\Zotero\Zotero\Profiles\<随机>.default\extensions\
核心用法
菜单操作说明
插件菜单非上下文感知，需按以下规则选择对象才能正确触发：
| 目标操作 | 在 Zotero 中选中 | 右键菜单选择 |
|---|---|---|
| 导出文献元数据为 Markdown | 单个 Zotero 条目 | Export to markdown |
| 导出 Zotero 笔记为 Markdown | 单个 Zotero 笔记 | Export to markdown |
| 创建自己的 mdnotes 文件 | 单个 Zotero 条目 | Create mdnotes file |
| 批量导出元数据+笔记 | 单个 Zotero 条目（触发批量） | Batch export to markdown |
菜单操作方式：右键点击 Zotero 条目或笔记 → 选择对应菜单项
导出文件命名规则
文件名由配置中的命名模板决定，默认格式（未修改配置时）大致为：{第一作者}_{年份}_{简短标题}.md。
具体模板规则需参考 configuration.md。
批量导出
选中任意一个 Zotero 条目 → 右键 → Batch export to markdown，将导出该条目的元数据、笔记，以及库中所有其他条目的元数据文件。⚠️ 批量导出前建议先备份文献库或确认导出路径。
典型适用场景
- Obsidian/Logseq + Zotero 联合工作流：在双链笔记中直接
![[文献slug.md]]嵌入引用 - 文献综述写作：批量导出元数据后，用 VS Code/Obsidian 搜索、标签化管理大量文献
- Markdown 优先的学术写作：用 Typora、Marktext 等工具撰写论文，引用本地 Markdown 文件
- 知识库构建：将 Zotero 文献库导出为静态 Markdown 文件树，部署到任何静态托管平台
坑与注意
⚠️ Zotero 7 不兼容（最关键）：当前（2026 年）Zotero 已发布 Zotero 7 系列，该插件无法在 Zotero 7 上运行。如果你已升级 Zotero 7，请直接使用 obsidian-zotero-integration 作为替代方案。
⚠️ 依赖推荐插件：插件作者明确表示未在无 Zotfile 和 BetterBibTeX 的环境下测试，批量导出等功能可能出现未知问题。推荐同时安装这两个插件。
⚠️ 菜单非上下文感知：不要在不正确的对象上触发菜单（比如在笔记条目上点击"导出元数据"），否则可能产生意外输出或静默失败。
⚠️ 活跃维护状态不明：GitHub 最后更新时间不详，且作者已明确表示没有时间继续维护，issue 响应可能不稳定。
⚠️ 导出路径需手动指定（除 Create mdnotes file 外）：每次导出都会弹出路径选择对话框，批量导出大量文献时需注意选择根目录。
与同类对比
| 插件 | Zotero 版本 | 主要功能 | 维护状态 |
|---|---|---|---|
| zotero-mdnotes（本插件） | Zotero 5 | 元数据+笔记→Markdown，批量导出 | ⚠️ 已停止维护 |
| obsidian-zotero-integration | Zotero 7 | Obsidian 双向同步、笔记链接 | 活跃维护 |
| zotero-better-bibtex | Zotero 5/6/7 | BibTeX/Citekey 导出，Markdown 笔记 | 活跃维护 |
| zotero-pandoc | Zotero 5 | 通过 Pandoc 导出多格式 | 维护一般 |
结论：如果你使用 Zotero 5 且需要将笔记批量导出为 Markdown 文件，zotero-mdnotes 仍是目前最直接的方案。如果你使用 Zotero 7，请直接选择 obsidian-zotero-integration。
一句话推荐结论
zotero-mdnotes 是 Zotero 5 用户将文献元数据和笔记批量接驳到 Obsidian/Logseq 等 Markdown 工作流的最简路径，零配置开箱即用——但它已是停止维护的遗留插件，Zotero 7 用户请立即切换到 obsidian-zotero-integration。