【免费下载】 Obsidian PDF++ 插件安装与配置指南

2026-01-21 04:53:57作者：彭桢灵Jeremy

An Obsidian.md plugin for annotating PDF files with highlights just by linking to text selection. It also adds many quality-of-life improvements to Obsidian's built-in PDF viewer and PDF embeds.

项目地址：https://gitcode.com/gh_mirrors/ob/obsidian-pdf-plus

1. 项目基础介绍和主要编程语言

项目基础介绍

Obsidian PDF++ 是一个为 Obsidian 笔记应用开发的插件，旨在提供更强大的 PDF 注释、查看和编辑功能。该插件允许用户在 Obsidian 中直接对 PDF 文件进行注释，并将这些注释与笔记无缝集成。PDF++ 不仅增强了 Obsidian 内置的 PDF 查看器，还引入了许多质量提升的功能，使其成为 Obsidian 用户处理 PDF 文件的理想工具。

主要编程语言

该项目主要使用 TypeScript 进行开发。TypeScript 是 JavaScript 的一个超集，提供了静态类型检查和更强大的面向对象编程特性，非常适合用于构建复杂的插件和应用。

2. 项目使用的关键技术和框架

关键技术和框架

TypeScript: 项目的主要编程语言，提供了类型安全和更强大的面向对象编程特性。
pdf-lib: 一个用于创建和修改 PDF 文档的 JavaScript 库，PDF++ 使用该库来实现直接在 PDF 文件中添加注释的功能。
Obsidian API: 项目依赖于 Obsidian 的 API 来实现与 Obsidian 应用的集成。
Vim 键绑定: 提供了可选的 Vim 键绑定，增强了用户的操作体验。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

安装 Obsidian: 确保你已经安装并配置好了 Obsidian 笔记应用。你可以从 Obsidian 官网下载并安装。
安装 Node.js: 项目依赖于 Node.js 环境。你可以从 Node.js 官网下载并安装。
安装 Git: 用于克隆项目代码。你可以从 Git 官网下载并安装。

详细的安装步骤

步骤 1: 克隆项目代码

首先，打开终端或命令提示符，导航到你希望存放项目的目录，然后运行以下命令克隆项目代码：

git clone https://github.com/RyotaUshio/obsidian-pdf-plus.git

步骤 2: 安装依赖

进入项目目录并安装项目依赖：

cd obsidian-pdf-plus
npm install

步骤 3: 构建项目

运行以下命令来构建项目：

npm run build

步骤 4: 安装插件到 Obsidian

在 Obsidian 中，打开“设置” -> “社区插件” -> “浏览”。
在搜索栏中输入“PDF++”，找到并安装该插件。
安装完成后，启用插件。

步骤 5: 配置插件

打开 Obsidian 的“设置” -> “PDF++”。
根据你的需求配置插件的各项设置，如启用 Vim 键绑定、设置默认高亮颜色等。

注意事项

确保你的 Obsidian 版本为 v1.5.8 或更高，以接收 PDF++ 的更新。
某些功能可能需要启用 Style Settings 插件。

通过以上步骤，你就可以成功安装并配置 Obsidian PDF++ 插件，开始在 Obsidian 中享受更强大的 PDF 注释和编辑功能。

obsidian-pdf-plus