pdf-inspector-windows

Convert text-based and scanned PDFs to Markdown on Windows with local OCR.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/narr07/permadi --skill pdf-inspector-windows-narr07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pdf-inspector-windows
Source: https://github.com/narr07/permadi/tree/main/.roo/skills/pdf-inspector-windows
Command: npx skills add https://github.com/narr07/permadi --skill pdf-inspector-windows-narr07

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdf-inspector, and includes scripts (resource) and references (resource) components.

What problem does it solve? Reading PDFs into an LLM or RAG pipeline is unreliable when files are scanned or have broken text layers, and most converters either lose heading/table structure or require paid cloud OCR that uploads your documents. This Skill converts any PDF to clean Markdown on Windows using Firecrawl's pdf-inspector, with fully local OCR for scanned pages. ## Core Features & Use Cases - Automatic PDF classification and conversion: Detects text-based, scanned, image-based, or mixed PDFs and extracts Markdown with heading, table, and reading-order awareness. - Local OCR for scanned pages: Uses PP-OCRv6 with pinned PDFium and ONNX Runtime libraries so scanned pages are recovered offline without sending documents to any cloud service. - Batch and selective processing: Convert entire folders recursively, specific page ranges, or get structured JSON output with OCR provenance and layout diagnostics. - Use Case: You receive a scanned contract PDF on a Windows machine and need its text for summarization. Run the wrapper script and get a UTF-8 Markdown file with the scanned pages OCR'd locally, plus a report of any low-confidence pages. ## Quick Start Ask the AI to convert a PDF file to Markdown, for example: "Convert C:\docs\report.pdf to Markdown using the pdf-inspector skill and tell me if any pages needed OCR."

Frequently Asked Questions about pdf-inspector-windows

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

FAQPage Schema
How do I convert a PDF to Markdown on Windows?▼

Run the read_pdf.py wrapper script with the PDF path and an output folder, for example read_pdf.py report.pdf -o out. It uses pdf-inspector to extract Markdown with heading and table detection, and writes UTF-8 files safe for PowerShell.

How to extract text from a scanned PDF without cloud OCR?▼

pdf-inspector performs local OCR using PP-OCRv6 with PDFium and ONNX Runtime libraries installed by the setup script. The document never leaves the machine; only the ~31MB model weights are downloaded once and cached.

pdf-inspector vs MarkItDown for PDF conversion?▼

pdf-inspector preserves headings and tables that MarkItDown drops, and MarkItDown silently returns empty output on scanned PDFs with no free local OCR path. pdf-inspector classifies scanned files and OCRs them locally.

Why does PDF OCR fail with a PDFium or ONNX Runtime error?▼

The OCR runtime libraries were not installed or the terminal was opened before the environment variables were set. Rerun setup_windows.ps1 without -SkipOcr, then open a new terminal so PDFIUM_LIB_PATH and ORT_DYLIB_PATH take effect.

Can pdf-inspector convert Word, Excel, or HTML files?▼

No, pdf-inspector only handles PDF documents. Word, Excel, PowerPoint, HTML, CSV, EPUB, and audio formats are out of scope and would require a different tool such as MarkItDown or anydoc.

Does PDF conversion work fully offline?▼

Text-based PDFs never touch the network at all. For scanned pages, pass --offline to prohibit the one-time OCR model download, using a model directory pre-populated on a machine with network access.