mineru

Extract Markdown with tables and formulas from math PDFs and images.

32|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/woodfishhhh/EZ_math_model --skill mineru-woodfishhhh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mineru
Source: https://github.com/woodfishhhh/EZ_math_model/tree/main/skills/ez-math-model/tools/mineru
Command: npx skills add https://github.com/woodfishhhh/EZ_math_model --skill mineru-woodfishhhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns hard-to-read math PDFs, scanned images, and complex layouts into editable Markdown so you can extract text, tables, and formulas reliably for modeling and writing.

Core Features & Use Cases

  • High-quality PDF/Image/Web Parsing: Converts academic PDFs and mixed attachments into Markdown with better structure on Chinese math content.
  • Table/Formular/Formula Support: Extracts tables and formulas when using the API-backed modes or local extraction with the right flags.
  • Use Case: When a competition problem PDF contains messy tables and formulas, you can convert it into Markdown and then feed the clean content into the modeling pipeline.

Quick Start

Use mineru to convert your attached problem PDF into Chinese Markdown by running the flash-extract flow for fast extraction of text, tables, and formulas.

Frequently Asked Questions about mineru

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

FAQPage Schema
How do I convert math PDFs to Markdown with table and formula extraction?

To convert math PDFs to Markdown, this tool applies flash-extract or token-based modes to parse complex layouts, preserving tables and formulas into clean editable text for downstream modeling.

Does this PDF parsing tool support Chinese math content and competition papers?

Yes, this PDF parsing tool supports Chinese math content by offering language selection like ch and ch_server, specifically handling competition problem PDFs with messy tables and complex formulas.

Can I extract tables and math formulas from scanned images?

You can extract tables and math formulas from scanned images by using the API-backed extraction modes, which convert complex layouts and mixed attachments into structured readable Markdown.

What is the best way to parse complex academic paper layouts for downstream modeling?

The best way to parse complex academic paper layouts is using flash-extract for fast text, table, and formula extraction, yielding clean Markdown content ready for your modeling pipeline.

What happens when API limits or network issues occur during PDF parsing?

When API limits or network issues occur during PDF parsing, the tool provides graceful fallbacks and supports a local CLI extraction mode to ensure you still get your Markdown output.

Do I need an Open API key to extract formulas from academic PDFs?

You do not strictly need an Open API key to extract formulas from academic PDFs, as the tool supports local CLI extraction with the right flags, though API-backed modes offer better structure.