pdf-parsing

Convert PDF documents into local Markdown and extracted image assets.

7|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/black-yt/skills --skill pdf-parsing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-parsing
Source: https://github.com/black-yt/skills/tree/main/pdf-parsing
Command: npx skills add https://github.com/black-yt/skills --skill pdf-parsing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires structai.

What problem does it solve?

This Skill removes the friction of reading PDFs by converting them into local Markdown that is searchable, copyable, and easier to inspect, while also extracting embedded images for later review.

Core Features & Use Cases

  • Local PDF parsing: Use structai.read_pdf to parse a PDF once and reuse the generated local Markdown on subsequent reads.
  • Image extraction: Capture images and layout resources from the PDF so figures and tables can be reviewed alongside the text.
  • Retry and cache handling: Handle MinerU token setup, proxy-related failures, and parsing cache reuse when the same PDF is processed again.
  • Use case: A researcher can parse a paper into Markdown, quickly jump to sections with text search, and inspect extracted figures without reopening the original PDF repeatedly.

Quick Start

Ask the assistant to parse the attached PDF into local Markdown and extracted images, then review the generated full.md file instead of the original document.

Frequently Asked Questions about pdf-parsing

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

FAQPage Schema
How do I convert a research paper PDF into searchable Markdown?

To convert a research paper PDF into searchable Markdown, the Skill parses the document using MinerU token authentication and outputs a local full.md file alongside extracted image assets for offline inspection and section navigation.

Can I extract images and figures from a PDF alongside the text?

Yes, you can extract images and figures from a PDF. The Skill captures embedded images and layout resources during parsing, saving them as local assets so you can review figures and tables without reopening the original document.

Do I need a MinerU token to parse PDFs into Markdown?

Yes, you need a MinerU token to parse PDFs into Markdown. The Skill requires structai.read_pdf configured with MinerU token authentication to handle document conversion, proxy-aware retries, and local cache reuse.

How does local cache reuse work when parsing the same PDF again?

Local cache reuse works by storing the generated Markdown and extracted images from the initial parse. When you process the same PDF again, the Skill retrieves the cached output directly, avoiding redundant MinerU parsing and reducing wait time.

What is the best way to handle proxy-related failures during PDF text extraction?

The best way to handle proxy-related failures during PDF text extraction is through the Skill's built-in proxy-aware retry handling, which manages MinerU token setup and automatically retries failed parsing requests.

Why should I convert a PDF to Markdown instead of reading the original file?

Converting a PDF to Markdown enables searchable, copyable text and quick section navigation. You can inspect extracted figures locally and reuse the Markdown output, removing the friction of navigating bulky original PDF documents.