pdf-extract-tables

Extract tables from PDF files with structure preservation across multi-page and merged-cell layouts.

1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/Tcuzzo/HydraAgent_public --skill pdf-extract-tables-tcuzzo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pdf-extract-tables
Source: https://github.com/Tcuzzo/HydraAgent_public/tree/main/hydra/schemes/bundles/document-processing/skills/pdf-extract-tables
Command: npx skills add https://github.com/Tcuzzo/HydraAgent_public --skill pdf-extract-tables-tcuzzo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdfplumber, camelot-py, tabula-py.

What problem does it solve? Extracting tabular data from PDFs is error-prone when tables span multiple pages, contain merged cells, or lack visible borders, forcing manual copy-paste work that loses structure and formatting. ## Core Features & Use Cases - Multi-Method Extraction: Uses pdfplumber for bordered tables, camelot-py lattice mode for grid-lined tables, and tabula-py stream mode for borderless layouts. - Structure Preservation: Handles merged cells by propagating values, maintains headers on continuation pages, and preserves numeric, date, and currency data types. - Multi-Page Table Merging: Detects continuation patterns to merge tables split across pages, including rows broken mid-page. - Use Case: A financial analyst receives a quarterly report PDF where the inventory table spans pages 10-15; this Skill merges it into a single 450-row Excel file with headers intact and flags ambiguous cells for review. ## Quick Start Extract all tables from quarterly-report.pdf and export them as CSV files, merging any tables that span multiple pages.

Frequently Asked Questions about pdf-extract-tables

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

FAQPage Schema
How do I extract tables from a PDF file?▼

Use pdfplumber for simple tables with clear borders, camelot-py in lattice mode for tables with grid lines, and tabula-py in stream mode for tables without borders. Detect table regions first through layout analysis, then export results to CSV, XLSX, or JSON.

How to extract a table that spans multiple PDF pages?▼

Detect continuation patterns across pages, preserve the header row on continuation pages, and handle rows broken mid-page during the merge. The result is a single unified table rather than separate per-page fragments.

pdfplumber vs camelot vs tabula for table extraction?▼

pdfplumber works best for simple tables with clear borders, camelot-py lattice mode suits tables with visible grid lines, and tabula-py stream mode handles tables without clear borders. Choosing based on table structure improves extraction accuracy.

Why does PDF table extraction return no tables?▼

Extraction fails when the PDF is a scanned image without a text layer, is encrypted or corrupted, or has a complex layout without borders. For scanned documents, apply OCR before table detection; for borderless layouts, switch to stream-mode extraction.

How are merged cells handled during PDF table extraction?▼

Merged cells are handled by propagating the merged value to all covered sub-rows, preserving the hierarchical structure in the output. Numeric formatting such as currency values is maintained, and ambiguous cells are flagged for manual review.