在 Obsidian 中使用红豆文献

Hongdou for Obsidian 让你在 Obsidian 中搜索红豆文献、插入可点击的文献链接,并为文献创建阅读笔记。

第一次使用,先完成下面的安装、授权和插入链接。阅读笔记、笔记与批注材料、引用登记可以按需要再用。

使用文献联动时,请在同一台电脑上打开红豆和 Obsidian,并保持红豆运行。

1. 安装插件,让两端连起来

安装并启用

  1. 用 Obsidian 打开准备使用的笔记库。
  2. 在红豆进入设置 → 插件与集成 → 应用联动 → Obsidian 连接,分别安装红豆端插件和Obsidian 端插件。
  3. 安装时按提示完全退出 Obsidian,完成后重新打开;红豆如提示重启,也按提示操作。在 Obsidian 的设置 → 第三方插件中启用 Hongdou for Obsidian。
  4. 在 Obsidian 设置左侧找到 Hongdou for Obsidian,进入红豆客户端联动。

如果使用多个 Obsidian 笔记库,每个库都要安装并启用插件。未找到笔记库或需要手动安装时,参见两端插件安装说明。

第一次连接,允许一次即可

  1. 在红豆客户端联动的“客户端连接”一行点击授权红豆联动。
  2. 切到红豆,在弹窗中确认是自己刚发起的请求,点击允许 Obsidian 联动。
  3. 回到 Obsidian,看到已授权 · 本机所有仓库可用后,在文献库中选择要使用的个人文献库或群组库。

也可以从红豆的设置 → Obsidian 联动 → 授权 Obsidian 联动发起,效果相同。

同一台电脑只需允许一次,本机其他已启用插件的笔记库也能联动。换到另一台电脑时,在那台电脑上重新授权即可,不用填写授权码或服务器地址。

2. 先试一次:插入文献链接

  1. 在 Obsidian 打开或新建一篇笔记,切到编辑视图或实时预览,把光标放在准备引用文献的位置。
  2. 按 Ctrl + P(Windows)/Command + P(macOS) 打开命令面板,搜索并运行插入红豆文献链接。
  3. 输入文献的标题、作者或年份,点击搜索结果勾选文献。
  4. 点击插入所选文献。回到笔记,即可看到可点击的文献标题。
搜索并勾选文献,然后插入当前笔记

先搜索,再选择文献并插入;图中的文献和笔记名称仅为示例。

在实时预览或阅读视图中,点击文献链接可以回到红豆查看来源。也可以点击 Obsidian 左侧的红豆图标打开文献搜索;窗口顶部的操作下拉框可切换为创建阅读笔记或打开附件。

一次可选择多篇文献,最多 20 篇。如果打开搜索窗口后又切换了笔记或光标位置,先点击使用当前笔记的插入位置,再插入。

3. 为一篇文献建立阅读笔记

想单独整理一篇文献的阅读心得时,使用创建或打开阅读笔记:

  1. 打开命令面板,运行创建或打开阅读笔记。
  2. 搜索并选择一篇文献。
  3. 插件会新建并打开阅读笔记,默认保存在红豆文献文件夹。

笔记中已经整理好文献信息和来源链接。你可以直接在一句话总结、核心观点、方法与证据、我的思考下面写自己的内容。

同一篇文献已有阅读笔记时,这个命令会打开已有笔记,不会重复创建。插入文献链接写入当前笔记;创建或打开阅读笔记则为文献单独建一篇笔记,按需要选择即可。

想在当前笔记中留下这篇阅读笔记的入口,可在搜索窗口的操作下拉框选择插入阅读笔记链接。

4. 打开附件、整理红豆笔记与批注

下面这些操作都可以从命令面板查找:

你想做什么 使用哪个命令
回到红豆查看一篇文献 在红豆中打开文献
阅读文献的 PDF 等附件 打开红豆文献附件
把红豆笔记、文字批注整理成独立的 Markdown 材料 另存红豆材料笔记
把材料补充到当前阅读笔记,或更新已有材料 更新当前阅读笔记的红豆材料

打开附件时,按提示选择文献和附件即可。插入文献链接不会把 PDF 复制到 Obsidian;请先确认该附件能在红豆中正常打开。

独立导入的材料默认保存在红豆文献/材料。在 Obsidian 中修改这些文字,不会改写红豆中的原笔记。图片、手写和部分复杂格式不属于完整导入范围,请先看预览。

需要更新阅读笔记中的材料时,先打开对应阅读笔记并切到阅读视图,再运行更新命令。核对预览后点击保存恢复副本并更新。插件会保留你自己的阅读心得;如果你也修改过同一段材料,先按提示核对。

要回看更新前的内容,打开对应阅读笔记,从文件菜单选择查看笔记更新备份。如果更新后又编辑过正文,请先核对后续修改,再按窗口提示处理。

5. 可选:让红豆显示哪些笔记引用了文献

如果你希望在红豆选中一篇文献时,看到“哪些 Obsidian 笔记引用了它”,再开启这项功能。只想插入链接、写阅读笔记,可以先跳过。

开启并登记

  1. 在 Obsidian 进入设置 → Hongdou for Obsidian → 红豆客户端联动。
  2. 展开在红豆查看引用笔记(可选),开启在红豆显示引用笔记。
  3. 插件创建的阅读笔记可直接参与登记。普通笔记插入文献链接后,打开命令面板运行让红豆显示本笔记的引用,按预览核对并确认关联。

回到红豆查看

  1. 在红豆文献列表选中对应的主文献条目,而不是其 PDF 附件或子笔记。
  2. 打开右侧的 Obsidian 引用面板。
  3. 点击笔记标题,回到引用这篇文献的笔记。

仅插入一个链接,不代表普通笔记已经登记。 需要关联多篇笔记或解除已有登记时,在上述设置分组点击打开管理,再选择相应操作。

这项设置按 Obsidian 笔记库分别开启。登记发送笔记标题、相对路径、文献标识和引用位置等回跳信息,不发送笔记正文。关闭开关会停止后续登记,已登记的记录保留。

6. 常用设置与插件更新

在红豆客户端联动 → 文献链接与笔记中,可以调整:

  • 引用显示文字:以后插入的链接显示文献标题、作者与年份,或自定义文字。
  • 文献阅读笔记文件夹:以后新建的阅读笔记保存到哪里;独立材料保存在该文件夹下的“材料”目录。

其他连接和修复工具位于红豆客户端联动 → 联动维护,正常使用时无需调整。

更新插件时,在红豆的设置 → 插件与集成 → 应用联动 → Obsidian 连接更新两端插件,完成后按提示重新加载或重启。请保留已有笔记和配置;不需要先撤销授权。

7. 常见问题

遇到的情况 先这样处理
找不到 Hongdou for Obsidian 设置 在当前笔记库的设置 → 第三方插件中启用插件;每个库需要分别启用。
提示红豆未连接 启动本机红豆,运行检查红豆连接;首次使用再完成联动授权。
搜不到文献,或搜到的不是预期文献 检查红豆当前账号,以及插件所选的文献库。
看不到插入命令,或无法插入 先打开 Markdown 笔记,切到编辑视图或实时预览,并放好光标。
红豆没有显示引用笔记 检查当前库是否开启在红豆显示引用笔记;普通笔记还要先确认关联。
红豆切换账号后要求核对连接 点击核对账号并连接,确认当前要使用的文献库,按提示继续。
更新后仍显示旧界面 从最新版红豆重新安装插件,再重启 Obsidian 加载。

红豆关闭时,已有 Obsidian 笔记仍可阅读和编辑;搜索文献、打开附件和更新材料等联动操作,需要重新打开红豆。

需要反馈问题时,提供两端插件版本、操作步骤和完整提示即可。发送截图前请遮挡账号和私人笔记内容。


本文按 Obsidian 端 0.4.5、红豆端 0.2.2 的界面编写。更新日期:2026 年 10 月 31 日。

文档更新时间: 2026-10-31 23:24   作者:管理员