Plugins / Files, sync & backup

Paper2MD

by Ming-321 · github.com/Ming-321/zotero-paper2md

Converts a PDF to a Markdown file with extracted images and YAML front matter of title, authors, year, DOI and tags, using the MinerU API.

Paper2MD has a Zotero Plugins grade of B (use with care) because a zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit), and 1 more finding. It works with Zotero 7–8, not the current Zotero 10. Last checked 15 Nov 2026.

View source
Downloads a .xpi file (0.04 MB). In Zotero, open Tools → Plugins and install it from the file.
In useAn estimate of how many copies of Zotero have it: Zotero downloads each new version once for every copy that has the plugin, so we count the downloads of its most-downloaded recent release. Rounded. Plugins that update from outside GitHub count low.
6
DownloadsAll-time downloads of its release files from GitHub, counting every update. Installs from elsewhere aren't counted.
6
Latest releaseDownloads of version 0.1.0, its latest release, since it came out on 19 Jan 2026. A new release starts from zero; Downloads counts every release.
6
ReleasesVersions published on GitHub. Everyone who has the plugin downloads each one again, which adds up in Downloads.
1
AgeTime since its GitHub repository was created, on 19 Jan 2026. The plugin can be younger than its repository.
10 months
StarsPeople who starred the repository on GitHub: a rough measure of interest.
1
ContributorsPeople who have committed code to this plugin. Bots don't count, nor do the authors of a template or project it was copied from.
1
LicenceThe licence the code is published under, as GitHub reports it.
AGPL-3.0
B
Zotero Plugins gradeUse with care
because a zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit), and 1 more finding
Applies to v0.1.0, released 19 Jan 2026Code checked · not yet tested in a live Zotero
Doesn't work with the current Zotero (10)Works with Zotero 7, 8.
What we found in the codeSets the gradeThe worst finding in these three areas sets the grade.
Code transparencyReadable code, uploaded by the project's automated GitHub buildThe release file was uploaded by the project's automated GitHub build. We haven't yet rebuilt it from the source to compare.LowLow concern: normal for plugins that do this job. Listed so you know.
Updates
Updates come from this project's GitHub repositoryThe update address offers this version
Where your data goesOnly contacts services we could identify1 address in 1 group.LowLow concern: normal for plugins that do this job. Listed so you know.
Apps you connect (1)
mineru.net
Where we found it
mineru.netcontent/scripts/paper2md.js · line 3675
var DEFAULT_API_URL = "https://mineru.net/api/v4";
Powerful capabilitiesA zotero:// link (a web page can open one) can make it install add-ons without asking you, and 3 moreMediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Medium concern (2)
A zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit)A zotero:// link can make it run code if you approve a prompt (from zotero-plugin-toolkit)
Low concern (2)
Stores API keys or passwordsWorks with files on your computer
Where we found it
A zotero:// link (a web page can open one) can make it install add-o…content/scripts/paper2md.js · line 129

zotero://plugin. zotero-plugin-toolkit removed this link in version 6.0.0; this plugin is built with an older version

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://plugin"] = pluginBridgeExtension;
A zotero:// link can make it run code if you approve a promptcontent/scripts/paper2md.js · line 85

zotero://ztoolkit-debug

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://ztoolkit-debug"] = debugBridgeExtension;
Before you installShown, not gradedFacts to help you decide. They don't change the grade.
Works withZotero 7, 8 · not 9, 10Doesn't work with the current Zotero (10)MediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Zotero 7 ✓ worksZotero 8 ✓ worksZotero 9 ✗ doesn't workZotero 10 ✗ doesn't workZotero 11 beta not tested yet: Zotero hasn't opened Zotero 11 testing
What you'll needAn API keyDetected automatically from its code
No further detail for this area yet.
MaintenanceSlowing down · last release 19 Jan 20261 contributor
No further detail for this area yet.
LanguagesDocumentation in EnglishInterface: English and Chinese
No further detail for this area yet.
We report what we found in the code. Open any area for the evidence.How we gradeReport a problem

What it does

Written by AI from the README

Converts a PDF to a Markdown file with extracted images and YAML front matter of title, authors, year, DOI and tags, using the MinerU API. Tags converted items and picks the original PDF when several exist.

Markdown is easier to feed to notes, search tools and AI than a PDF. Needs a MinerU API key, with a free tier available. The PDF is sent to MinerU for conversion.

What you'll need

Detected automatically
  • An API keyNeeds a key you get from the service (MinerU). What needs it: MinerU API key for PDF to Markdown conversion.
  • Zotero 7, 8Not working with Zotero 10

Where your data goes

We found: only contacts services we could identify. 1 address in 1 group.

Apps you connect (1)
mineru.net
Evidence · file and line
mineru.netcontent/scripts/paper2md.js · line 3675
var DEFAULT_API_URL = "https://mineru.net/api/v4";

Other plugins that do this

Matched on what they do

For the same job, work with Zotero 10 and graded B or better. Closest match first.

  • B
    Attachments to Markdown

    Converts web snapshots, EPUBs and Word (.docx) attachments into clean Markdown with YAML front matter, saved images and footnotes, as a new Markdown attachment.

    Matches “markdown with front matter” · 108 downloads · Active · Zotero 8–10, 11 beta
    Works with Zotero 10Actively maintained
  • A
    PDF to Markdown for Zotero

    Converts PDF attachments to Markdown with the MinerU service and attaches the .md file next to the PDF.

    Matches “pdf to markdown” · 1,062 downloads · Active · Zotero 7–10
    Works with Zotero 10Actively maintained
  • B
    ZotMD

    Sends the PDF or Office file of selected items to MinerU for OCR and saves the result as a Markdown child attachment with images.

    Matches “convert pdf to markdown” · 165 downloads · Active · Zotero 7–10
    Works with Zotero 10Actively maintained
Compare all 4 side by side
How we pick these

By how closely what they do matches this plugin, using descriptions and the phrases people search with. Copies and forks of this plugin are listed under Forks and copies instead. No plugin pays to appear here.

Forks and copies

No forks listed.

The developer's response

The developer hasn't responded. Developers can reply here, and their reply sits next to our findings.I'm the developer

Ratings and reviews

What people who use it say. This is separate from the grade, which is what the code does, and never changes it.

No ratings yet.

Write a review
Your rating of Paper2MD v0.1.0

Your review is public, under the name you give, and published with the directory's data under CC BY 4.0. Links are removed. We never store your IP address: a scrambled code made from it is kept for 30 days to catch fake reviews. Every review is checked before it's published; how fake ones are spotted isn't published, so it can't be gamed.

Install Paper2MD
BUse with care
Before you install: A zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit), and 1 more finding.Read the finding
Compare with similar plugins