mineru-pdf

Parse PDF documents into structured Markdown or JSON using the magic-pdf library.

36|2|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/malue-ai/dazee-small --skill mineru-pdf-malue-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mineru-pdf
Source: https://github.com/malue-ai/dazee-small/tree/main/instances/xiaodazi/skills/mineru-pdf
Command: npx skills add https://github.com/malue-ai/dazee-small --skill mineru-pdf-malue-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires magic-pdf, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of converting PDF documents into structured Markdown or JSON formats, preserving essential elements like headings, tables, and lists, while ensuring data privacy by processing locally.

Core Features & Use Cases

  • Structured Content Extraction: Extracts text, tables, and images from PDFs, maintaining document hierarchy.
  • Local Processing: Operates entirely on the user's machine, ensuring data privacy.
  • Use Case: Convert a research paper PDF into a well-formatted Markdown document for easier reading and referencing, or extract tabular data from a financial report PDF into a JSON file for further analysis.

Quick Start

Use the mineru-pdf skill to convert the PDF file located at /path/to/document.pdf into Markdown format.

Frequently Asked Questions about mineru-pdf

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

FAQPage Schema
How do I parse a PDF into Markdown locally?

To parse a PDF into Markdown locally, use this Skill to extract text, tables, and images on your machine, preserving document structure without uploading data. It outputs a well-formatted Markdown file.

Can I extract tables from a scanned PDF into JSON?

Yes, you can extract tables from a scanned PDF into JSON. The Skill uses OCR to process scanned documents locally, extracting structured tabular data and outputting it as a JSON file for analysis.

Does this PDF parsing approach preserve document headings and lists?

Yes, this PDF parsing approach preserves document headings and lists. It uses the magic-pdf library to maintain the original document hierarchy, ensuring structured Markdown or JSON output that reflects the source layout.

What is the best way to convert a research paper PDF for easier reading?

The best way to convert a research paper PDF for easier reading is using this Skill. It transforms the document into structured Markdown locally, preserving headings and extracting images while ensuring data privacy.

Do I need an internet connection to extract data from PDFs into JSON?

No, you do not need an internet connection to extract data from PDFs into JSON. The Skill operates entirely on your local machine, ensuring data privacy by processing both text-based and scanned PDFs offline.

Are there limitations when parsing PDFs locally with magic-pdf?

Limitations when parsing PDFs locally with magic-pdf depend on document complexity. While it handles text, tables, images, and OCR for scanned files, heavily corrupted or non-standard PDF structures may not parse correctly into Markdown or JSON.