DeepPaperNote

Turn one complex paper into an Obsidian note you will actually want to keep.

English | 简体中文

Read one paper deeply. Add one durable page to your academic wiki.

You sit down to study an important paper. The hard part is not reading it—it is turning what you understood into a note you can still use later. The time usually disappears into work like this:

• switching between the PDF, Zotero, web pages, and your note app
• manually organizing metadata, the abstract, figures, and the method backbone
• understanding part of the paper, then spending even longer turning that understanding into a coherent note
• ending up with something that looks complete but is not a note you actually want to revisit

DeepPaperNote takes over that repetitive, mechanical, and surprisingly expensive layer of paper reading. It gathers the material, builds the structure, places figures in context, and shapes the final note so you can keep your attention on the paper's real ideas.

In other words, you can think of DeepPaperNote as the single-paper ingestion layer for an LLM-maintained academic wiki: it reads one paper deeply and turns its research question, methods, evidence, results, and figures into a durable page that people can read and agents can reuse. Obsidian is where those pages live, connect, and grow; DeepPaperNote is how a paper reliably enters the wiki.

DeepPaperNote is an agent skill for reading one paper at a time. The same core skill runs in Claude Code and Codex, and it focuses on the questions that distinguish a deep-reading note from an abstract rewrite:

• What problem is the paper actually solving?
• How does the method, system, or analytical mechanism really work?
• Are the key formulas, experimental conclusions, and figure context preserved?
• Will the result become a useful long-term Obsidian note rather than a disposable summary?

[!tip] If you already use Obsidian or Zotero, DeepPaperNote automates the most time-consuming and error-prone parts of evidence gathering, organization, and note production.

📰 News

• [v2.3.0] 🌐 Added complete English note support across note structure, figure callouts, validation, and Formal Save. Release notes
• [2026-07-16] 🧩 Added paper-glossary, an optional companion skill for building reusable Obsidian terminology notes.
• [2026-07-16] 🔌 DeepPaperNote is now distributed as a plugin for multiple agents, with support for selecting multiple skills from the repository. PR #12

News lists only the three most recent user-facing milestones. See the changelog and GitHub Releases for the full history.

🚀 Quick Start

1. Install the plugin

Claude Code — install from the plugin marketplace:

claude plugin marketplace add 917Dhj/DeepPaperNote

claude plugin install deeppapernote@deeppapernote

Any agent — install with the skills CLI:

npx skills add 917Dhj/DeepPaperNote

Both routes install the same skills. The plugin route brings both deeppapernote and paper-glossary; the skills CLI installer lets you choose which skills to install and which agents should receive them. For most users, start with deeppapernote; add paper-glossary only if you want reusable terminology notes.

2. Install the core PDF dependency

python3 -m pip install PyMuPDF

If you use uv, install PyMuPDF into the same Python environment that DeepPaperNote will use:

uv pip install PyMuPDF

DeepPaperNote requires Python 3.10 or newer. PyMuPDF powers the core PDF extraction path.

3. Hand a paper to your agent

A title, DOI, URL, arXiv ID, or local PDF all work. Zotero items are also supported when a compatible integration is available.

Generate a deep-reading note for this paper: <title, DOI, URL, arXiv ID, or local PDF>
Turn this paper into an Obsidian note: 

🔌 Collect Papers from Your Browser

Use DeepPaperNote Connector to save paper PDFs from your browser into your Obsidian paper library. When you are ready to read deeply, hand the saved PDF to DeepPaperNote and generate a note in the same paper directory, keeping the source and your understanding together. Different PDF versions can have their own corresponding notes; existing notes remain protected.

Connector is an optional browser extension, currently supporting Chrome on macOS with a local saving component. You can also continue giving DeepPaperNote a title, DOI, URL, or local PDF directly.

Explore Connector and installation instructions →

🎯 Why DeepPaperNote?

You may be dealing with...	DeepPaperNote helps by...
📄 You finished the paper, but your notes are still a pile of fragments	Rebuilding the research question, method chain, central experiments, and limitations into one note you can actually read again
🧠 You do not want another polished-looking AI summary	Preserving the formulas, numbers, figure context, and evidence boundaries that make the paper worth understanding
🗂️ You keep reading papers, but they never become your academic wiki	Turning each paper into a searchable, linkable, reusable Obsidian knowledge page so your academic wiki grows one paper at a time
📚 The paper is already in Zotero, and you do not want to match or download it again	Preferring local records and attachments when available, reducing repeated work and paper mismatches

🧩 Skills

DeepPaperNote remains the main product. The repository also includes an optional companion skill that works from DeepPaperNote's saved paper artifacts without taking o