mineru-pdf-converter

Convert PDFs to Markdown via the MinerU cloud API.

54|19|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/Xueheng-Li/sysu-awesome-cc --skill mineru-pdf-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mineru-pdf-converter
Source: https://github.com/Xueheng-Li/sysu-awesome-cc/tree/main/skills/mineru-pdf-converter
Command: npx skills add https://github.com/Xueheng-Li/sysu-awesome-cc --skill mineru-pdf-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

MinerU PDF Converter eliminates the tedious manual work of converting PDFs and related documents into clean, developer-friendly Markdown while preserving formulas, tables, and layout for archival and sharing.

Core Features & Use Cases

  • Converts PDFs, images, and other documents to Markdown with preserved formulas and tables.
  • Automatically splits large PDFs (>600 pages) into chunks, converts, and merges results.
  • Supports additional outputs: LaTeX, DOCX, and HTML; token-based authentication via MinerU API.
  • Use cases include academic paper conversion, contract/document digitization, and bulk report preparation.

Quick Start

Run the MinerU converter with a local PDF path and your token file to start a conversion.

Frequently Asked Questions about mineru-pdf-converter

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

FAQPage Schema
How do I convert large PDFs to Markdown automatically?

To convert large PDFs to Markdown, this tool automatically splits documents exceeding 600 pages into smaller chunks, processes them via the MinerU cloud API, and merges the results into a single Markdown file.

Can I convert PDFs to LaTeX, DOCX, or HTML instead of just Markdown?

Yes, you can convert PDFs to LaTeX, DOCX, and HTML in addition to Markdown. The conversion uses the MinerU API to preserve formulas, tables, and layout across these output formats.

Do I need a MinerU API token to convert local PDF files?

Yes, you need a MinerU API token to convert local PDF files. The batch upload workflow requires token-based authentication to process your documents through the MinerU cloud API.

What is the best way to extract specific page ranges from a PDF into Markdown?

To extract specific page ranges into Markdown, use the URL-based task flow which supports optional page range parameters, allowing you to convert only the sections you need without processing the entire document.

How does converting PDFs with tables and formulas to Markdown work?

Converting PDFs with tables and formulas to Markdown works by sending files to the MinerU API, which parses the document structure and preserves complex elements like mathematical formulas and table layouts in the output.

Why does my PDF conversion fail on very large documents?

Large PDF conversions fail due to processing limits, but this tool handles it by automatically splitting documents over 600 pages into chunks, converting each separately, and merging the Markdown output.