# RyotaUshio/obsidian-pdf-plus

PDF++: the most Obsidian-native PDF annotation & viewing tool ever. Comes with optional Vim keybindings.

Repository: https://github.com/RyotaUshio/obsidian-pdf-plus
Canonical: https://ross.abutalabs.com/products/obsidian-pdf-plus
Homepage: https://ryotaushio.github.io/obsidian-pdf-plus/
Language: TypeScript
License: MIT
License Family: permissive
Topics: obsidian, pdf, pdf-annotation, pdf-editor, pdf-generation, obsidian-plugin, vim, pdf-viewer
Last push: 2025-08-30T02:10:22+00:00

## Health v2 (maintenance only)
Score: 47/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 39, release rhythm 45, longevity 70
- inputs: {"age_days": 989, "days_push": 369, "days_rel": 369, "gap_med": 3.5, "n_releases_24m": 23}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2421, forks 82 (observed 2026-08-28T04:06:50.561245+00:00)

## What it is
PDF++ is an Obsidian.md community plugin that upgrades Obsidian's built-in PDF viewer into a full annotation and viewing tool. It lets users create highlight annotations by linking to text selections, store annotations as pure markdown notes distributed across the vault, or embed them directly in PDF files, with optional Vim keybindings.

## Use cases
- annotate pdfs with highlights inside obsidian
- take markdown notes linked to pdf text selections
- view and read pdfs in obsidian with better navigation
- keep pdf annotations as plain markdown instead of proprietary json
- add vim keybindings to pdf reading
- replace zotero or marginnote for pdf annotation workflows

## When to choose
- you already use Obsidian and want native PDF annotation without external apps
- you want annotations stored as portable markdown that survives plugin removal
- you want annotations distributed across your vault rather than locked in one file

## When to avoid
- you need a standalone PDF editor outside Obsidian
- you require heavy PDF form filling or editing features
- you don't use Obsidian.md at all

## Facets
- artifact type: plugin
- maturity: active
- function: pdf, pdf-viewer, markdown, editor
- domain: pdf, text-editors, developer-tools, files
- platform: editor-plugin, cross-platform
- tags: obsidian-plugin, pdf-annotation, pdf-viewer, vim-keybindings, note-taking, typescript, desktop

## Member repositories
- RyotaUshio/obsidian-pdf-plus (main) score 47

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:50.561245+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:33:02.810572+00:00, confidence not recorded.
  - readme: https://github.com/RyotaUshio/obsidian-pdf-plus (fetched 2026-08-28T04:06:50.561245+00:00, sha 781db82606d1)
  - homepage: https://ryotaushio.github.io/obsidian-pdf-plus/ (fetched 2026-08-29T10:13:40.782869+00:00, sha e577dc67e944)
- Data as of 2026-08-30T08:39:29.467469+00:00.
