opendataloader-pdf

Extract structured Markdown, JSON, and HTML data from PDF documents.

733|99|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/chujianyun/skills --skill opendataloader-pdf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opendataloader-pdf
Source: https://github.com/chujianyun/skills/tree/main/skills/media/opendataloader-pdf
Command: npx skills add https://github.com/chujianyun/skills --skill opendataloader-pdf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires opendataloader-pdf.

What problem does it solve?

Extracting structured data from PDFs for RAG pipelines or LLM training is painful: tables break, reading order gets scrambled, and scanned pages return nothing. This Skill wraps OpenDataLoader PDF, a benchmark-leading parser, to convert PDFs into clean Markdown, JSON with bounding boxes, or HTML.

Core Features & Use Cases

  • Multi-format extraction: Convert PDFs to Markdown, JSON (with per-element bounding box coordinates), or HTML for downstream chunking and rendering.
  • Hybrid AI mode: Handle complex tables, scanned documents via OCR, and math formulas using the optional hybrid mode with docling-fast.
  • Source traceability: Every extracted element carries bbox coordinates, so you can trace any paragraph or table back to its exact page position.
  • Use Case: Batch-convert a folder of academic PDFs into JSON with bounding boxes, then feed the structured output into a RAG indexing pipeline with page-level citations.

Quick Start

Install opendataloader-pdf with pip and ask the agent to convert a PDF file into Markdown and JSON output in a chosen directory.

Frequently Asked Questions about opendataloader-pdf

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

FAQPage Schema
How do I convert a PDF to Markdown in Python?

Install opendataloader-pdf with pip, then call opendataloader_pdf.convert with the input path, output directory, and format set to markdown. The CLI equivalent is opendataloader-pdf input.pdf output_dir/.

What PDF parser works best for RAG pipelines?

OpenDataLoader PDF scores 0.90 overall on the opendataloader-bench benchmark, ahead of docling, marker, and mineru. It outputs Markdown and JSON with bounding boxes, which suits chunking and source citation in RAG pipelines.

Does opendataloader-pdf support scanned PDFs and OCR?

Yes, scanned documents are handled in hybrid mode by adding --force-ocr to the command. For non-English scans, pass language codes with --ocr-lang, for example "ko,en".

How do I extract tables with bounding box coordinates from a PDF?

Use the JSON output format, where each element includes a bbox array with x0, y0, x1, y1 coordinates plus its type and content. Tables are returned as HTML inside the JSON structure.

Why is batch PDF conversion slow when calling convert in a loop?

Each convert() call starts a new JVM process, so looping over files repeatedly pays that startup cost. Pass all files or folders in a single convert call to amortize JVM startup.

When should I use hybrid mode instead of the default fast mode?

Use the default fast mode for standard digital PDFs. Switch to hybrid mode with docling-fast for complex borderless tables, scanned pages, or documents containing math formulas.