mineru-pdf-to-md

Convert local PDFs to Markdown via MinerU v4 API with Bearer token authentication.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mengdehong/opencode-dotfiles --skill mineru-pdf-to-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mineru-pdf-to-md
Source: https://github.com/mengdehong/opencode-dotfiles/tree/main/skills/mineru-pdf-to-md
Command: npx skills add https://github.com/mengdehong/opencode-dotfiles --skill mineru-pdf-to-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Converts local PDFs to Markdown using MinerU v4 API, enabling automated extraction and formatting of document content with optional enterprise token support.

Core Features & Use Cases

  • Authentication: Bearer token via MINERU_API_TOKEN with optional enterprise token header token for business deployments.
  • End-to-end flow: Upload PDF -> get batch URL -> poll results -> download ZIP -> extract full.md.
  • Use Case: Convert a scanned or digital PDF into a clean Markdown draft for knowledge bases or documentation pipelines.

Quick Start

Run the script with your local PDF to generate a Markdown document.

Frequently Asked Questions about mineru-pdf-to-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a local PDF to Markdown using an API?

To convert a local PDF to Markdown using an API, this Skill uploads your file to the MinerU v4 API, polls for completion, and extracts the generated full.md file from the downloaded ZIP archive.

What is the process to extract text from a PDF into a Markdown draft?

Extracting text from a PDF into a Markdown draft involves authenticating with a Bearer token, uploading the PDF, polling the MinerU API for results, and extracting the final Markdown file from the ZIP.

Do I need a specific token to authenticate PDF conversion with MinerU?

Yes, you need the MINERU_API_TOKEN as a Bearer token to authenticate PDF conversion with MinerU, and you can optionally include an enterprise token header for business deployments.

Can I use a Python script for batch upload of PDFs to Markdown?

Yes, you can use this Python script for batch upload of PDFs to Markdown via the MinerU API, which requires the requests library to handle the HTTP communication and ZIP extraction.

Does MinerU API conversion support different paper modes and model versions?

MinerU API conversion supports different paper modes and model versions, allowing you to flexibly configure the extraction workflow when converting your local PDFs into Markdown format.