Getting started

Install Mktero in five steps

Mktero is a restartless extension for Zotero 7 through 10. Download the XPI, add it from the plugin manager, sign in, and open your next PDF as Markdown.

The five steps

  1. Download the XPI

    Take mktero-<version>.xpi from the latest release. Formal releases then update automatically through Zotero; drafts and prereleases do not.

  2. Open the plugin manager

    In Zotero, choose Tools → Plugins.

  3. Install from file

    Open the gear menu, choose Install Add-on From File..., select the XPI, and follow the prompts. No restart is needed.

  4. Sign in to Mktero

    Open Settings → Mktero and sign in or register. The default converter uses your Mktero account, so no separate OCR key is required.

    Credentials are stored as ordinary, unencrypted preferences in the active Zotero profile. To keep a PDF off the Mktero service, choose MinerU or Mistral there and enter that service’s own key.

  5. Open a PDF as Markdown

    Right-click a PDF or library item and choose Read as Markdown with Mktero, or click the Mktero icon in the reader toolbar.

Once you are in

Prepare many at once

Select several items and choose Prepare selected Markdown, or right-click a collection and choose Prepare collection Markdown. A collection covers only its own PDFs, not its subcollections. A batch converts three PDFs at a time in Zotero’s progress window, and minimizing it keeps preparation running.

Updates and cache

Zotero updates formal releases on its own. A valid local cache skips the remote conversion; the cache key includes the PDF hash and the parser profile, so a changed profile reconverts.

Where the PDF goes

On a cache miss the default converter sends the complete PDF to the Mktero service you signed in to. Switch to your own MinerU or Mistral in Settings → Mktero and the PDF goes there instead.

Read the privacy notes

Good to know

  • Mktero tabs are session-only and do not return after a Zotero restart. Closing a tab does not cancel a running conversion; disabling the extension does.
  • The Markdown surface is read-only. Corrections are stored as revisions and never rewrite the cached conversion.
  • Only local PDFs are supported. Scanned files can be converted, but highlights need a text layer to land precisely.
  • Standalone notes, area and image annotations, and ink are not shown in the Markdown view.

Stuck somewhere?

Ask in the community channels, or report what happened with the Zotero and Mktero versions.