mineru

Convert PDFs and complex documents into Markdown and JSON structures.

27|9|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/Leoyishou/personal-ai-company --skill mineru-leoyishou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mineru
Source: https://github.com/Leoyishou/personal-ai-company/tree/main/claude-global/skills/api-pdf2markdown
Command: npx skills add https://github.com/Leoyishou/personal-ai-company --skill mineru-leoyishou

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

将 PDF 等文档转换为 LLM 可读的 Markdown/JSON 格式,保留结构、提取表格、公式、图片,并支持 109 种语言的 OCR,极大降低复杂文档处理的时间成本。

Core Features & Use Cases

  • 保留文档结构(标题、段落、列表)
  • 提取表格(转 Markdown 表格)
  • 提取公式(转 LaTeX)
  • 提取图片及描述
  • 支持 109 种语言 OCR
  • 自动识别扫描件并启用 OCR
  • 推荐用法:官方云 API

Quick Start

直接运行 convert.py 并使用云 API 将 document.pdf 转换为 Markdown/JSON。

Frequently Asked Questions about mineru

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

FAQPage Schema
How do I convert a scanned PDF to Markdown while preserving tables and formulas?

This tool converts PDFs to Markdown and JSON by preserving document structure, automatically detecting scanned documents to apply OCR, and extracting tables and formulas into Markdown and LaTeX formats respectively.

Can I extract tables from a PDF into JSON format for large language model parsing?

Yes, you can extract tables from PDFs into JSON format. The tool converts complex documents into structured JSON and Markdown outputs, ensuring reliable parsing and readability for large language models.

Does PDF OCR support multilingual document processing?

Yes, PDF OCR supports multilingual document processing. It recognizes and extracts content from documents across 109 languages while maintaining the original document structure and formatting.

What is the best way to convert complex PDFs to Markdown for LLM ingestion?

The best way to convert complex PDFs to Markdown is using the official cloud API. Running the convert.py script processes documents instantly, preserving structure and extracting images for reliable LLM ingestion.

Do I need a local environment setup to run OCR on PDF documents?

You do not need a complex local environment setup to run OCR on PDFs. While local processing via CLI is supported, using the recommended cloud API through the convert.py script requires only the requests dependency.

Why does my PDF to Markdown conversion fail on complex mathematical formulas?

PDF to Markdown conversion handles complex formulas by extracting them directly into LaTeX format. If extraction fails, ensure you are using the recommended cloud API for optimal processing of complex mathematical structures.