PDF Scholia Scribe

Citation-focused PDF annotation and note-linking for Obsidian.

Overview
Scorecard
Updates26

PDF Scholia Scribe is a citation-focused fork of PDF++ for Obsidian. It is built for reading PDFs while writing scholarly notes: copy a passage, keep the link back to the exact PDF selection, and show a quiet citation label in the note instead of a long file/page/colour link.

The fork keeps the powerful PDF++ backlink-highlighting system, but changes the writing workflow around it:

copied PDF selections can render as author-date citations such as (Deleuze 1983:124), APA or Harvard-style page citations, or numbered citations such as [1];
a visible Search this PDF toolbar button opens the native PDF search bar with occurrence highlighting, result counts, and previous/next navigation;
in-text citation paste can produce "quoted passage" (Author year:page) with the PDF link hidden under the citation text;
quote and callout paste formats are still available, including callout headers that can use your colour labels instead of an icon;
PDF page labels are preferred over raw PDF page indexes, so books with front matter can cite page 47 instead of the PDF viewer's internal page number;
Zotero-backed citation insertion can search Zotero and vault source notes, with a Zotero only option for noisy vaults and a Date only option for sentences where the author is already named;
reference-list generation can collect citations in the current note and build a managed References section;
recent fixes make the colour-toolbar paste format obey the selected copy style, reduce paper/file icon noise, preserve editor scroll position after auto-paste, and use a desktop Zotero local-API fallback when Obsidian's browser-style request path cannot reach Zotero.

This is still a PDF++ fork, not a replacement for Zotero. Zotero is used for citation metadata and formatted references; PDF Scholia Scribe handles the Obsidian PDF link, highlight, paste, and note-writing workflow.

What is in the pipeline

PDF Scholia Scribe is the Obsidian plugin part of a larger Scholia direction: helping a research library become easier to cite, review, and turn into finished scholarly notes. The plugin will keep focusing on the moment where reading becomes writing: PDF selections, clean citation labels, Zotero metadata, reference lists, and links that still point back to the exact passage.

The next work is aimed at making that workflow calmer and more dependable:

cleaner citation and reference-list handling across Zotero records, vault source notes, and PDF quote links;
safer internals that stay closer to Obsidian review expectations while preserving the PDF++ annotation workflow;
better outline, page-label, and annotation-copy tools for long books and article collections;
clearer settings for people who want citation-first notes without having to understand every inherited PDF++ option.

Scholia is the broader research-library project around this plugin. Where PDF Scholia Scribe works inside Obsidian while you read and write, Scholia is intended to help with the wider scholarly workflow: keeping sources organised, improving metadata, finding gaps in a literature set, and moving from collected PDFs toward usable arguments and bibliographies.

PDF Scholia Scribe is maintained by Michelle G Dyason. It is a fork of PDF++, with extra tools for quieter scholarly notes, citation-like PDF links, Zotero-backed citations, date-only citations, labelled callouts, and reference-list generation.

Review and safety disclosures

PDF Scholia Scribe is a maintained fork of PDF++, and a large part of the inherited PDF viewer integration is still based on PDF++ compatibility code. The compatibility layer lives mainly in src/patchers/ and src/typings.d.ts; it touches Obsidian PDF viewer and PDF.js surfaces that are not all covered by stable public APIs. Those paths are guarded defensively, but PDF viewer internals can change between Obsidian releases.

Zotero support is local-first. When you use Zotero citation search or reference-list generation, the plugin may query the Zotero local API at the configured base URL, which defaults to http://127.0.0.1:23119. It uses Obsidian's requestUrl first, and on desktop can fall back to a local Node HTTP request to the same localhost endpoint if the browser-style request path cannot reach Zotero. It does not contact Zotero cloud by default.

The citation workflow also reads vault Markdown notes to match source metadata, citation keys, Zotero item keys, and PDF quote links. Copy, paste, outline-copy, citation, debug export, and debug import commands can write to or read from the system clipboard when the user explicitly invokes those actions.

PDF editing features are optional. If enabled, commands such as writing highlights or links into a PDF, changing annotation colors, deleting annotations, inserting pages, deleting pages, or extracting pages can modify PDF files in the vault. Keep backups of important PDFs before using direct PDF-writing features, especially with heavily annotated files from other PDF apps.

The manifest is not marked desktop-only because the core PDF link, highlight, and copy workflows are intended to run on mobile too. Desktop-only behavior is guarded in code: opening PDFs with the operating-system default app, Electron file dialogs or file-path access, direct filesystem adapter cleanup, and the Zotero local Node fallback are disabled or skipped outside the desktop app.

About PDF Scholia Scribe

PDF Scholia Scribe starts from the central PDF++ idea: a Markdown link to a PDF selection can become a highlight in the PDF viewer. That is useful because the note remains ordinary Markdown, while the PDF still shows where the quoted passage came from.

The main change in this fork is how those links look and behave while writing. The original copied link could expose a lot of technical detail: file names, PDF page indexes, colour names, and source markers. PDF Scholia Scribe keeps the same link target, but lets the visible label read like a citation. A copied passage can therefore sit naturally in prose, for example:

"Since the strong could prevent themselves from acting, the weak could act if they did not prevent themselves" (Deleuze 1983:123).

Changes made in this fork so far include:

renamed and rebranded the plugin as PDF Scholia Scribe, with Michelle G Dyason as maintainer and funding links in the plugin metadata;
added citation display formats for copied PDF links, including ASA-style author-date, Harvard, APA, and numbered citation labels;
added cleaner copy formats for citation-only paste, quoted sentence paste, quote blocks, and callouts;
hid the extra PDF/source marker under the citation text where possible, so the note is less cluttered;
removed the noisy callout icon by default and allowed callout headings to show the colour label you gave the highlight colour;
fixed the colour-toolbar copy action so choosing In-text citation, Quote, or Quote in callout is respected when you click a colour;
improved page-number handling by using page labels where the PDF provides them;
added a setting to reduce note-jumping after auto-paste;
added a desktop fallback for Zotero's local API, so Zotero search still works when Obsidian's browser-style request path cannot reach Zotero.

The fork also adds a small Zotero-and-vault citation workflow. You can run Insert citation from Zotero or vault, search for a source, choose whether to search Zotero, the vault, or both, and insert either an author-date citation or a date-only citation. Date-only citations are useful when the sentence already names the author, for example:

Pires argues that urban agriculture needs planning support (2011:47).

For notes with many citations, Update reference list for current note creates or refreshes a managed reference list at the end of the note. The updater recognises citations inserted by PDF Scholia Scribe, ordinary @citekey references, links to vault source notes, and PDF quote links that can be matched to a source note.

These Zotero features are separate from PDF++'s original Citations in PDF (experimental) section. That original feature is for citation links already inside a PDF. PDF Scholia Scribe's added citation workflow is for writing in your Obsidian note, using Zotero metadata and your vault source notes.

This is an Obsidian.md plugin for a better PDF experience. Specifically:

It transforms backlinks to PDF files into highlight annotations, i.e. you can annotate PDF files with highlights just by linking to text selection.
Alternatively, you can add annotations directly into PDF files so that they are also visible outside Obsidian (but with limitations; see here).
Moreover, it adds many quality-of-life improvements to the built-in PDF viewer and PDF embeds. So it's useful even if you don't use it as an annotation tool (you can even turn off the annotation functionality!).

PDF++ stands out among other PDF annotation tools for the following reasons:

PDF++ acts as a complement to Obsidian's native PDF viewer rather than replacing it. It allows you to make sidenotes as pure markdown, so you will not lose your annotations even if the plugin stops working as long as Obsidian is alive. It will not leave behind a pile of unreadable JSON even if this plugin stops working in the future, unlike Annotator.

I'm not a fan of .md files that are actually not markdown at all. The value of the markdown format does not lie in the file extension!
PDF++ makes Obsidian work as a stand-alone PDF annotation tool. You can seamlessly annotate your PDFs using Obsidian's rich markdown editor without switching between Obsidian and an external app like Zotero or Marginnote.
Annotations for a single PDF are no longer confined to a single file and can be distributed across the whole vault. It establishes a novel, Obsidian-native way of PDF annotation.
PDF++ does not introduce plugin-dependent syntaxes except for a few optional ones (&color=.../&rect=... link parameters).

🚀 Install
📖 Read the docs (Note: it's still a work in progress!)
💬 Ask & answer questions
❗ Report bugs (Tip: when something is not working, first restart Obsidian by running the Reload app without saving command.)

[!note]

Some features require the Style Settings plugin enabled.

If you're an Android user and have trouble with PDF++, first try updating Android System WebView (if you are on Android 7-9, update Chrome instead).

[!warning] This plugin retains PDF++'s private PDF viewer compatibility layer, so there is still a risk that some PDF-viewer features may break when Obsidian changes its built-in PDF internals (background).

Getting started

Here I'm just scratching the surface of what PDF++ can do. See below and the plugin settings in Obsidian for more details. Also note that each feature can be toggled on and off in the plugin settings, which lets you customize this plugin to best fit into your use case.

Seamless integration with other community plugins

Blazingly fast workflow with Hover Editor

It's also friendly to laptops with small display sizes. See here for the details.

https://github.com/RyotaUshio/obsidian-pdf-plus/assets/72342591/cb292049-bd89-4cd1-9d72-a02828d765e0

Transform the backlinks pane into ZotLit-like annotation view with Better Search Views & PDF++ callouts

See here for the details.

Highly customizable copy formats

https://github.com/RyotaUshio/obsidian-pdf-plus/assets/72342591/fb624769-4cc3-4d4e-9898-b17d0a5591e3

Rectangular selection embeds

Learn more

https://github.com/RyotaUshio/obsidian-pdf-plus/assets/72342591/7a6331ab-71bf-45d0-a457-7984e487e326

`Ctrl`/`Cmd`+hover over highlights to preview or open backlinks

Depends on the Action when hovering over highlighted text setting.

Preview

https://github.com/RyotaUshio/obsidian-pdf-plus/assets/72342591/ea14d06a-70f6-45cf-a142-0213adb9749b

Open

https://github.com/RyotaUshio/obsidian-pdf-plus/assets/72342591/5f3dded8-79ad-44cc-816f-dc697dc4a343

Filter backlinks by page

Show only backlinks to the page that is currently opened in the PDF viewer.

https://github.com/RyotaUshio/obsidian-pdf-plus/assets/72342591/4147e634-7864-40b4-b916-a6db40b85f31

"Hover sync" between PDF viewer & backlinks pane

https://github.com/RyotaUshio/obsidian-pdf-plus/assets/72342591/2285a837-0588-4a72-8193-da25a456bf84

Features

Each feature can be toggled on and off in the plugin settings.

Backlink highlighting

Annotate PDF files with highlights just by linking to text selection. You can easily copy links to selections using color palette in the toolbar. See the "Color palette" section for the details.

Highlight backlinks in PDF viewer: In the PDF viewer, any referenced text will be highlighted for easy identification.
- By default, all backlinks are highlighted. However, there is an option that allows you to highlight only backlinks with colors specified in the link text (see below).
- It does not modify the PDF file itself. It just changes how the file content is displayed in Obsidian. PDF++ also offers an option to add highlights to PDFs directly.
Custom highlight colors: Append &color=<COLOR NAME> to a link text to highlight the selection with a specified color.
- <COLOR NAME> is one of the colors that you register in the plugin settings. e.g [[file.pdf#page=1&selection=4,0,5,20&color=red]]
- Color names are case-insensitive, i.e. all of &color=red, &color=RED and even &color=rEd work the same.
- You can use the color palette in PDF toolbars to easily copy links with &color=... appended automatically. See the "Color palette" section for the details.
- You can also opt not to use this plugin-dependent notation and apply a single color (the "default highlight color" setting) to all highlights.
Easily navigate to backlinks by pressing Ctrl/Cmd (by default) while hovering over a highlighted text in PDF viewer: you can choose what happens when you hover over a highlighted text between the following:
- Open backlink
- Popover preview of backlink
Double click a piece of highlighted text to open the corresponding backlink

PDF++ callouts

Create callouts with the same color as the highlight color without any CSS snippet scripting.

Backlink pane improvements

These features make Obsidian a unique PDF annotation tool that tightly connects PDFs to your ideas stored as markdown files.

Filter backlinks by page: Show only backlinks to the page that is currently opened in the PDF viewer.
Hover sync (PDF viewer → Backlinks pane): Hovering over highlighted text or annotation will also highlight the corresponding item in the backlink pane.
Hover sync (Backlinks pane → PDF viewer): In the backlinks pane, hover your mouse over a backlink item to highlight the corresponding text or annotation in the PDF viewer.

Editing PDF files directly (experimental)

Add, edit, and delete highlights and links in PDF files. Added annotations will be visible even outside Obsidian, unlike backlink highlights.

PDF++ will not modify PDF files themselves unless you explicitly allow it. The author assumes no responsibility for any data corruption. Please make sure you have a backup and use it at your own risk. Report any issues you encounter here.

PDF page composer: PDF counterpart of the "Note Composer" core plugin

Add, insert, remove or extract PDF pages via commands and automatically update related links in the entire vault.

Add, rename, move and delete PDF outline items (a.k.a. table of contents / bookmarks)

Allow PDF modification and right-click on the PDF outline. Alternatively, you can use the command "Add to outline" to add a new item, or drag & drop outline items to move it under another item.

Edit page labels

Learn more

PDF internal links enhancement

Make it easier to work with internal links embedded in PDF files.

Show a popover preview of PDF internal links by hover+command/ctrl: See below for advanced CSS customization.
Enable history navigation for PDF internal links: When enabled, clicking the "navigate back" (left arrow) button will take you back to the page you were originally viewing before clicking on an internal link in the PDF file.
Copy PDF link as Obsidian link: (Requires custom right-click menu enabled) In the PDF viewer, right-click a PDF-embedded link and then click "Copy PDF link as Obsidian link". It will copy the PDF link as an Obsidian link that you can paste into markdown files. Clicking the pasted link will take you to the same destination as the original PDF link.
"Copy link to current page view" command: Running this command while viewing a PDF file will copy a link, clicking which will open the PDF file at the current scroll position and zoom level.
Paste copied link to a text selection in a PDF file: (Requires custom right-click menu & PDF editing enabled) After copying a link by the above actions, you can "paste" it to a selection in PDF to create a PDF internal link. To do this, right-click the selection and click "Paste copied link to selection".

Opening links to PDF files

Open PDF links cleverly

Don't open a single PDF file in multiple tabs: When opening a link to a PDF file without pressing any modifier keys, a new tab will not be opened if the same file has already been opened in another tab. Useful for annotating PDFs using a side-by-side view ("Split right"), displaying a PDF on one side and a markdown file on another.
- You can optionally highlight the existing tab to enhance visual feedback.
Open PDF links next to the existing PDF tab: If there is a PDF file opened in a tab, clicking a PDF link will first create a new tab next to it and then open the target PDF file in the created tab. This is especially useful when you are splitting the workspace vertically or horizontally and want PDF files to be always opened on one side.
Don't move focus to PDF viewer after opening a PDF link
Open PDF links with an external app: See below for the details.

Other options

Always record navigation history when opening PDF links: By default, the history is recorded only when you open a link to a different PDF file. If enabled, the history will be recorded even when you open a link to the same PDF file as the current one, and you will be able to go back and forth the history by clicking the left/right arrow buttons even within a single PDF file.
Open PDF link instead of showing popover preview when target PDF is already opened: Press Ctrl/Cmd while hovering a PDF link to actually open it if the target PDF is already opened in another tab.
Clear highlights after a certain amount of time
Ignore the height parameter in popover preview: Obsidian lets you specify the height of a PDF embed by appending &height=... to a link, and this also applies to popover previews. Enable this option if you want to ignore the height parameter in popover previews.

Copying links to PDF files

Copy links with ease

Color palette in PDF toolbar: A color palette will be added to the toolbar of the PDF viewer. Clicking a color while selecting a range of text will copy a link to the selection with &color=... appended.
- You can customize the format of copied text using a powerful templating system (see below).
Copy link to selection or annotation command: This command allows you to trigger the copy-link action specified in a dropdown menu in the PDF toolbar quickly via a hotkey. I recommend using Ctrl+Shift+C/Cmd+Shift+C.
Copy & auto-paste link to selection or annotation command: In addition to copying a link, this command automatically pastes the copied link at the end of the note where you last pasted a link.

Note: these commands cannot be triggered from the Command Palette. Make sure that you set custom hotkeys for them.
Toggle "select text to copy" mode icon in the left ribbon menu: While it's turned on, the Copy link to selection or annotation command will be triggered automatically every time you select a range of text in a PDF viewer, meaning you don't even have to press a hotkey to copy a link.

Copy PDF internal links as Obsidian links

See here for the details.

Link copy templates

You can customize the template format used when copying a link to a selection or an annotation in PDF viewer. Each {{...}} in the template resolves a supported template variable, such as {{linkWithDisplay}}, {{textMarkdown}}, or {{citation.harvard}}. See the plugin settings for the details.

Custom display text format
Custom color palette actions: Customize the commands that you can trigger by clicking a color palette item while selecting a range of text in PDF viewer.
Use another template when no text is selected: For example, you can use this to copy a link to the page when there is no selection.

Customize the behavior of Obsidian's built-in right-click menu in PDF view.

Copy link with/without display text: When copying a link to a selection or an annotation in a PDF file, Obsidian appends |<PDF FILE TITLE>, page <PAGE NUMBER> to the link text by default. This plugin allows you to disable this behavior if you don't like it.
Display text format: You can customize the display text format.

Copy link to section from PDF outline (table of contents)

Replace the built-in right-click menu in the outline with a custom one: This enables you to copy a section link with a custom format by right-clicking an item in the outline.
Drag & drop outline item to copy link to section: Grab an item in the outline and drop it to a markdown file to create a section link.

Copy link to page from PDF thumbnail

Replace the built-in right-click menu in the thumbnail with a custom one: This enables you to copy a page link with a custom display text format specified in the PDF toolbar by right-clicking a thumbnail.

Note: The Minimal theme has an issue where thumbnails cannot be right-clicked to open a menu when combined with Style Settings (details).
Drag & drop PDF thumbnail to copy link to section: Grab a thumbnail image and drop it to a markdown file to create a page link.

Note: When disabled, drag-and-drop will cause the thumbnail image to be paste as a data url, which is seemingly Obsidian's bug.

Embedding PDF files

Click PDF embeds to open links: Clicking a PDF embed will open the embedded file.
Trim selection embeds: When embedding a selection from a PDF file, only the selection and its surroundings are displayed rather than the entire page.
- You can specify the margin as well.
Hide toolbar in PDF embeds with a page specified: Requires the Style Settings plugin.
Never show sidebar in PDF embeds
Don't display PDF embeds or PDF popover previews in "two page" layout: Regardless of the "two page" layout setting in existing PDF viewer, PDF embeds and PDF popover previews will be always displayed in "single page" layout. You can still turn it on for each embed by clicking the "two page" button in the toolbar, if shown.
Don't highlight text in a text selection embeds/don't highlight annotations in an annotation embeds
Don't clear highlights in a selection/annotation embeds
Make PDF embeds unscrollable
Zoom in PDF embeds (experimental)

Keyboard shortcut commands

PDF++ offers the following commands for reducing mouse clicks on the PDF toolbar by assigning hotkeys to them.

Search this PDF: Open and focus the current PDF's search bar. Matches are highlighted and can be traversed with the previous/next controls.
Show outline / show thumbnail
Close PDF siderbar
Zoom in / zoom out
Fit width / fit height
Go to page: This command brings the cursor to the page number input field in the PDF toolbar. Enter a page number and press Enter to jump to the page.
Show copy format menu / show display text format menu: By running thes commands via hotkeys and then using the arrow keys you can quickly select a format from the menu without using the mouse.
Enable PDF edit / disable PDF edit

Integration with external apps (desktop-only)

Open PDF links with an external app: Open PDF links with the OS-defined default application for PDF files. You can choose whether the same PDF file should be opened in Obsidian as well.
Sync the external app with Obsidian: When you focus on a PDF file in Obsidian, the external app will also focus on the same file.

Misc

Render markdown in sticky notes

CSS customization

You can customize the styling of various components of PDF++ using CSS snippets.

Text highlights

Here is a list of CSS selectors to target:

.textLayer .mod-focused: Obsidian's native text selection highlights shown when opening links to text selections in PDFs
.annotationLayer .mod-focused: Obsidian's native annotation highlights shown when opening links to annotations in PDFs
.pdf-plus-backlink-highlight-layer .pdf-plus-backlink: PDF text highlights that PDF++ generates from backlinks
- Use .pdf-plus-backlink-highlight-layer .pdf-plus-backlink[data-highlight-color="<COLOR NAME>"] to target a specific color
.pdf-plus-backlink-highlight-layer .pdf-plus-backlink.hovered-highlight: PDF text highlights that PDF++ generates when you hover over an item in the backlinks pane

Callout colors

The highlight colors that you define in the Highlight colors setting are also available as CSS variables. For example, a color named "Yellow" will be converted into a variable --pdf-plus-yellow-rgb. Its value is a tuple of the RGB values, e.g. 255, 208, 0. Note that non-alphanumeric characters are replaced with hyphens in variable names. For example, a color with name "Super LONG name!!" will result in a variable name --pdf-plus-super-long-name-rgb.

Additionally, the color specified in the Default highlight color setting is also available as --pdf-plus-default-color-rgb.

You can use these CSS variables for various purposes. For example, you can create a callout whose color matches the highlight color in the PDF viewer.

1. Different colors within a single callout type

[!NOTE] Update: Now you have the "PDF++ callouts" feature, which allows you to get the same result without writing CSS snippets on your own.

Here we use a callout type "PDF" as an example, but it can be anything you like.

Copy format:

> [!PDF|{{colorName}}] {{linkWithDisplay}}
> {{text}}

Result example:

> [!PDF|yellow] [[file.pdf#page=1&selection=0,1,2,3&color=yellow|file, page 1]]
> Lorem ipsum

> [!PDF|red] [[file.pdf#page=1&selection=0,1,2,3&color=red|file, page 1]]
> Lorem ipsum

> [!PDF|] [[file.pdf#page=1&selection=0,1,2,3|file, page 1]]
> Lorem ipsum

or without pipe ("|") after the callout type ("PDF"):

> [!PDF] [[file.pdf#page=1&selection=0,1,2,3|file, page 1]]
> Lorem ipsum

CSS snippet:

.callout[data-callout="pdf"][data-callout-metadata="yellow"] {
    --callout-color: var(--pdf-plus-yellow-rgb);
}

.callout[data-callout="pdf"][data-callout-metadata="red"] {
    --callout-color: var(--pdf-plus-red-rgb);
}

.callout[data-callout="pdf"] {
    --callout-color: var(--pdf-plus-default-color-rgb);
}

2. Color by callout types

Another approach is to associate each highlight color to a specify callout type such as "Note" or "Important".

Copy format:

> [!{{colorName}}] {{linkWithDisplay}}
> {{text}}

Result example:

> [!note] [[file.pdf#page=1&selection=0,1,2,3&color=note|file, page 1]]
> Lorem ipsum

> [!important] [[file.pdf#page=1&selection=0,1,2,3&color=important|file, page 1]]
> Lorem ipsum

CSS snippet:

.callout[data-callout="note"] {
    --callout-color: var(--pdf-plus-note-rgb);
}

.callout[data-callout="important"] {
    --callout-color: var(--pdf-plus-important-rgb);
}

Sometimes, you may find page preview popovers too tall.

For example, suppose you're reading a LaTeX-generated paper. You can hover over an inline citation (e.g. "Author et al., 2024") to show a popover preview of the corresponding entry in the bibliography section (see [[Citation links]]). Since a bib entry is usually not that tall, the popover often has too much vertical space.

Now, use the following CSS snippet to remove the extra space:

.popover.hover-popover.pdf-plus-pdf-internal-link-popover[data-dest^="cite."] {
    --popover-pdf-height: 100px; /* Change this to your liking */
}

The data-dest attribute is the ID of the named destination (i.e. link target) that the internal link points to, which typically starts with cite. for bibliographic items. In general, you can get the ID by the following steps:

Press command+option+I (macOS) / Ctrl+Shift+I (windows) to open the developer tool.
Click the arrow icon at the top-left corner of the dev tool to enter the inspection mode.
Click the PDF internal link that you want to inspect. Then, an <a> element will be highlighted in the "Elements" tab of the dev tool.
The href attribute of the <a> element is the destination ID with a hash sign (#) prepended.

You can also find a great tutorial on the forum.

Note on saving annotations directly in PDF

Although PDF++ is primarily designed with backlink highlighting (= annotation by backlink) in mind, it is also possible to add annotations directly inside PDF files. However, you will notice some limitations, including the viewer being reloaded every time you add a highlight to your file. Therefore, this feature should be considered to be a temporary workaround until Obsidian itself supports PDF annotation, which is on their roadmap.

Update 2024-08-20: I've just found a new plugin called Pdf Annotator. For now, it does not save annotations in PDF itself. However, it says it will be able to do so once Obsidian's PDF.js version is updated to 4.x. For those who prefer in-file annotations to backlink highlighting, this might be a better solution. Fortunately, it seems to be compatible with PDF++, meaning you can use features from both of two plugins at the same time although some of PDF++ features (e.g. hover over a highlight to preview backlinks, double-click on a highlight to open backlinks, etc.) are not available for annotations made by the Pdf Annotator plugin.

Installation

When approved, you will be able to install this plugin from within Obsidian's community plugin browser.

Alternatively, you can install the current GitHub release directly from this repository using BRAT.

Install the latest version of BRAT and enable it.
(Optional but highly recommended) In the BRAT settings, turn on Auto-update plugins at startup at the top of the page.
Open the following URL in the browser: obsidian://brat?plugin=MichelleGDyason/pdf-scholia-scribe.
Click the "Add Plugin" button.

You can also add the plugin in BRAT with this repository slug:

MichelleGDyason/pdf-scholia-scribe

Credits

PDF++ is built on top of Obsidian's native PDF viewer powered by Mozilla's PDF.js, which is already pretty good even without PDF++. Without the awesome work of the Obsidian team and the PDF.js maintainers, PDF++ would not have been possible.

PDF++ extends the native viewer by using monkey-around, an awesome patching library by PJ Eby. It is used by countless Obsidian plugins and has been helping the community as an infrastructure providing a foundation of Obsidian's high extendability. He's also the author of several popular Obsidian plugins including Tag Wrangler.

PDF++ offers two ways to highlight text in PDF: one that does not involve modifying the PDF file, and the other that writes highlight annotations directly into the PDF file. The latter is powered by the pdf-lib, a JavaScript library for creating and modifying PDF documents. The original project was created by Andrew Dillon. PDF++ uses a forked version maintained by Cantoo Scribe.

PDF++ also supports Vim-like keybindings. Its design was inspired by codemirror-vim and Tridactyl. Especially, some code for the link mode was borrowed from Tridactyl, which is distributed under the Apache 2.0 License by Colin Caine, Oliver Blanthorn and Koushien with some modification.

Compatibility

I'm trying to keep PDF++ compatible with the following plugin(s) as much as possible:

The following plugin(s) alters Obsidian's internals in such a way that prevents some aspects of other plugins from working properly, so I don't recommend using it together with this plugin.

Close Similar Tabs

Development principles

Always stick around Obsidian's built-in PDF viewer.
Don't introduce plugin-dependent stuff as much as possible.
- It can be tolerated only if
  - it brings a massive benefit
  - and it won't leave anything that becomes just a random mess without this plugin.

Support development

If PDF Scholia Scribe supports your reading and writing, you can support Michelle's work here:

GitHub Sponsors: github.com/sponsors/MichelleGDyason
Buy Me a Coffee: buymeacoffee.com/michellegdyason

HealthExcellent

ReviewPassed

About

Read and annotate PDFs while writing scholarly notes, preserving exact-selection links and showing quiet citation labels instead of long file/page links. Copy passages as author–date, APA/Harvard, numbered, or quoted citations with hidden PDF links; prefer PDF page labels, pull Zotero metadata, and generate a managed References section.

PDF Annotation Research

Details

Current version

1.0.3

Last updated

4 days ago

Created

Last month

Updates

26 releases

Downloads

188

Compatible with

Obsidian 1.12.7+

Platforms

Desktop, Mobile

License

MIT

Sponsor

Buy Me a Coffee

GitHub Sponsors

Author

michellegdyason

github.com/MichelleGDyason

michellegdyason

PDF Scholia Scribe

What is in the pipeline

Review and safety disclosures

About PDF Scholia Scribe

Getting started

Link to PDF files to annotate them with highlights

Color palette for easily copying links & specifying highlight colors

Copy links quickly via a hotkey

Seamless integration with other community plugins

Blazingly fast workflow with Hover Editor

Transform the backlinks pane into ZotLit-like annotation view with Better Search Views & PDF++ callouts

Highly customizable copy formats

Rectangular selection embeds

Ctrl/Cmd+hover over highlights to preview or open backlinks

Preview

Open

Filter backlinks by page

"Hover sync" between PDF viewer & backlinks pane

Features

Backlink highlighting

PDF++ callouts

Backlink pane improvements

Editing PDF files directly (experimental)

PDF page composer: PDF counterpart of the "Note Composer" core plugin

Add, rename, move and delete PDF outline items (a.k.a. table of contents / bookmarks)

Edit page labels

PDF internal links enhancement

Opening links to PDF files

Open PDF links cleverly

Other options

Copying links to PDF files

Copy links with ease

Copy PDF internal links as Obsidian links

Link copy templates

Right-click menu options

Copy link to section from PDF outline (table of contents)

Copy link to page from PDF thumbnail

Embedding PDF files

Keyboard shortcut commands

Integration with external apps (desktop-only)

Misc

CSS customization

Text highlights

Callout colors

1. Different colors within a single callout type

2. Color by callout types

Popover preview of PDF internal links

Note on saving annotations directly in PDF

Installation

Credits

Compatibility

Development principles

Support development

PDF Scholia Scribe

What is in the pipeline

Review and safety disclosures

About PDF Scholia Scribe

Getting started

Link to PDF files to annotate them with highlights

Color palette for easily copying links & specifying highlight colors

Copy links quickly via a hotkey

Seamless integration with other community plugins

Blazingly fast workflow with Hover Editor

Transform the backlinks pane into ZotLit-like annotation view with Better Search Views & PDF++ callouts

Highly customizable copy formats

Rectangular selection embeds

Ctrl/Cmd+hover over highlights to preview or open backlinks

Preview

Open

Filter backlinks by page

"Hover sync" between PDF viewer & backlinks pane

Features

Backlink highlighting

PDF++ callouts

Backlink pane improvements

Editing PDF files directly (experimental)

PDF page composer: PDF counterpart of the "Note Composer" core plugin

Add, rename, move and delete PDF outline items (a.k.a. table of contents / bookmarks)

Edit page labels

PDF internal links enhancement

`Ctrl`/`Cmd`+hover over highlights to preview or open backlinks

`Ctrl`/`Cmd`+hover over highlights to preview or open backlinks