# pdf-inspector | Firecrawl | Knowledge Base | Instagit Fast Rust library for PDF inspection, classification, and text extraction. Intelligently detects scanned vs text-based PDFs to enable smart routing decisions. GitHub Stars: 9.9k Repository: https://github.com/firecrawl/pdf-inspector --- ## Articles ### [How pdf-inspector Extracts MCID References from Tagged PDFs via Structure Tree Parsing](/firecrawl/pdf-inspector/pdf-inspector-structure-tree-parsing-mcid-references) Discover how pdf-inspector extracts MCID references from tagged PDFs. It parses the Structure Tree to map MCIDs to roles, preserving document hierarchy for accurate data extraction. - Tags: deep-dive - Published: 2026-09-02 ### [How the PDF-Inspector Vision Module Fusion Pipeline Combines Native Text with OCR Results](/firecrawl/pdf-inspector/pdf-inspector-vision-module-fusion-pipeline-native-ocr) Discover how the PDF-Inspector vision module fuses native text with OCR results using a geometry-aware, quality-driven system. Select the best content source per page for superior accuracy. - Tags: internals - Published: 2026-09-02 ### [What Is the TiledScanDetector Threshold for Aggregate Pixel Detection in pdf‑inspector?](/firecrawl/pdf-inspector/pdf-inspector-tiledscandetector-aggregate-pixel-threshold) Discover the TiledScanDetector threshold for aggregate pixel detection in pdf-inspector. Learn how 2 million pixels trigger tiled scan identification in your documents. - Tags: deep-dive - Published: 2026-09-02 ### [How pdf-inspector Uses Horizontal Projection Histograms for Robust Column Detection](/firecrawl/pdf-inspector/pdf-inspector-column-detection-horizontal-histograms) Discover how pdf-inspector uses horizontal projection histograms to accurately detect columns by identifying empty vertical strips as gutters for robust page splitting. - Tags: deep-dive - Published: 2026-09-02 ### [How PDF‑Inspector's NFKC Normalization Performs Ligature Expansion](/firecrawl/pdf-inspector/pdf-inspector-nfkc-normalization-ligature-expansion) Discover how PDF-Inspector expands ligatures using NFKC normalization and explicit Latin ligature matching. Learn more about this essential text processing feature. - Tags: deep-dive - Published: 2026-09-02 ### [How pdf-inspector's Content Stream Operator State Machine Handles Tj, TJ, Td/TD, Tm, q, and Q](/firecrawl/pdf-inspector/pdf-inspector-content-stream-operator-handling) Explore how pdf-inspector's state machine processes content stream operators like Tj, TJ, Td, Tm, q, and Q in Rust to extract structured text and bounding boxes. - Tags: internals - Published: 2026-09-02 ### [ProcessMode::Full vs Analyze vs DetectOnly in pdf-inspector: 3 Pipeline Modes Explained](/firecrawl/pdf-inspector/pdf-inspector-processmode-differences) Understand ProcessMode::Full, Analyze, and DetectOnly in pdf-inspector. Learn which pipeline mode best suits your PDF analysis needs for faster results or complete conversion. - Tags: deep-dive - Published: 2026-09-02 ### [How pdf-inspector Uses Union-Find to Detect Rectangle-Based Tables in PDFs](/firecrawl/pdf-inspector/pdf-inspector-union-find-rectangle-table-detection) Discover how pdf-inspector leverages the union-find algorithm to efficiently detect rectangle-based tables in PDFs by clustering overlapping elements using a disjoint-set structure. - Tags: internals - Published: 2026-09-02 ### [How the Otsu Threshold Function Powers Tiled‑Scan Detection in pdf‑inspector](/firecrawl/pdf-inspector/pdf-inspector-otsu-threshold-tiled-scan-detection) Learn how the Otsu threshold function in pdf-inspector detects tiled-scan PDFs by separating intra-word from inter-word gaps using variance maximization. - Tags: deep-dive - Published: 2026-09-02 ### [How PDFium Is Integrated into the pdf-inspector OCR Rendering Pipeline](/firecrawl/pdf-inspector/pdf-inspector-pdfium-integration-ocr-pipeline) Discover how pdf-inspector integrates PDFium as its rasterization engine using a Rust wrapper to convert PDF pages into images for OCR backends. Learn about the OCR rendering pipeline. - Tags: internals - Published: 2026-09-02 ### [How pdf-inspector Determines Heading Levels from Font-Size Ratios](/firecrawl/pdf-inspector/pdf-inspector-markdown-module-heading-tiers-font-size) Discover how pdf-inspector uses font-size ratios to determine heading levels. Learn about base font size comparison, bold text tiers, and fallback thresholds. - Tags: how-to-guide - Published: 2026-09-02 ### [How pdf-inspector Makes CMap Decisions for Font Width and Encoding](/firecrawl/pdf-inspector/pdf-inspector-font-width-encoding-cmap-decisions) Discover how pdf-inspector decides CMap for font width and encoding by sampling, scoring Unicode quality, and caching the best choice after analyzing 240 bytes of data. - Tags: internals - Published: 2026-09-02 ### [How pdf-inspector Extracts H1-H6 Heading Roles from Tagged PDF Structure Trees](/firecrawl/pdf-inspector/pdf-inspector-tagged-pdf-structure-tree-heading-roles) Discover how pdf-inspector extracts H1-H6 heading roles from PDF structure trees. It reads semantic tags, maps MCIDs, and converts them into Markdown headings. - Tags: deep-dive - Published: 2026-09-02 ### [How the pdf-inspector Layout Module Differentiates Newspaper vs. Tabular Reading Orders](/firecrawl/pdf-inspector/pdf-inspector-layout-module-reading-order-differentiation) Learn how pdf-inspectors layout module identifies newspaper vs tabular reading orders. Discover its techniques for column detection, line grouping, and layout classification. - Tags: deep-dive - Published: 2026-09-02 ### [How pdf-inspector Detects Broken Font Encodings: Three Heuristics Explained](/firecrawl/pdf-inspector/pdf-inspector-encoding-issue-detection-font-encodings) Learn how pdf-inspector detects broken font encodings using three heuristics: replacement characters, dollar-as-space patterns, and substitution-cipher garbling. Improve your PDF text extraction. - Tags: deep-dive - Published: 2026-09-02 ### [How pdf-inspector's Garbage Text Detection Upgrades Mixed PDFs to Scanned Status](/firecrawl/pdf-inspector/pdf-inspector-garbage-text-detection-mixed-to-scanned) Discover how pdf-inspector's garbage text detection upgrades Mixed PDFs to Scanned status by identifying and flagging corrupted text layers, ensuring accurate OCR processing. - Tags: deep-dive - Published: 2026-09-02 ### [How pdf-inspector Optimizes Document Loading to Share Data Between Detection and Extraction](/firecrawl/pdf-inspector/pdf-inspector-document-loading-optimization) Discover how pdf-inspector optimizes document loading by using a single lopdf Document for detection and extraction, eliminating redundant parsing and improving efficiency. - Tags: performance - Published: 2026-09-02 ### [How pdf-inspector's Region-Based Text Extraction Supports Hybrid OCR Pipelines](/firecrawl/pdf-inspector/pdf-inspector-region-based-text-extraction-hybrid-ocr) pdf-inspector enhances hybrid OCR pipelines by extracting native PDF text from specific regions, using vision models for bounding boxes and falling back to GPU OCR only when necessary. - Tags: deep-dive - Published: 2026-09-02 ### [CID Font Support in pdf-inspector: How It Decodes Type0/Identity-H Fonts](/firecrawl/pdf-inspector/pdf-inspector-cid-font-support-type0-identity-h) Learn how pdf-inspector decodes Type0/Identity-H CID fonts using a three-stage fallback: ToUnicode CMap parsing, TrueType cmap extraction, and CID-to-Unicode passthrough. - Tags: deep-dive - Published: 2026-09-02 ### [How pdf-inspector's Selective OCR Routing for Page Selection Works](/firecrawl/pdf-inspector/pdf-inspector-selective-ocr-routing-logic) Discover how pdf-inspector's selective OCR routing balances automatic detection and user control with its three-mode system for efficient page selection. - Tags: internals - Published: 2026-09-02 ### [How to Run Tests for pdf-inspector: A Complete Guide to Cargo Testing](/firecrawl/pdf-inspector/how-to-run-tests-for-pdf-inspector) Learn how to run tests for pdf-inspector with Cargo testing. Execute unit, integration, and OCR-specific tests easily using simple commands. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Build a Release Binary for pdf‑inspector: A Complete Guide](/firecrawl/pdf-inspector/how-to-build-a-release-binary-for-pdf-inspector) Build a release binary for pdf-inspector with a simple cargo command. Generate optimized binaries for pdf2md, detect-pdf, and dump_ops. Follow our complete guide for easy compilation. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Programmatically Use pdf-inspector in Rust: Complete API Guide](/firecrawl/pdf-inspector/how-to-programmatically-use-pdf-inspector-in-rust) Programmatically use pdf-inspector in Rust with our complete API guide. Process PDFs for text or OCR, and get Markdown output and metadata. Learn more now! - Tags: api-reference - Published: 2026-09-01 ### [How pdf-inspector Uses Tagged PDF Structure for Semantic Classification: A Technical Deep Dive](/firecrawl/pdf-inspector/how-does-pdf-inspector-use-tagged-pdf-structure-for-semantic-classification) Discover how pdf-inspector leverages tagged PDF structure for accurate semantic classification, mapping roles like H1-H6 and P directly to Markdown for superior content preservation. - Tags: deep-dive - Published: 2026-09-01 ### [How pdf-inspector's Font Encoding Fallback Mechanism Decodes PDFs Without ToUnicode CMaps](/firecrawl/pdf-inspector/what-is-the-fallback-mechanism-for-font-encoding-in-pdf-inspector) Discover how pdf-inspector's font encoding fallback mechanism decodes PDFs without ToUnicode CMaps using multiple strategies for robust text extraction. - Tags: internals - Published: 2026-09-01 ### [How pdf-inspector Handles PDF Encodings with CMap Parsing: A Deep Dive into ToUnicode Extraction](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-pdf-encodings-with-cmap-parsing) Discover how pdf-inspector expertly parses PDF encodings using CMap and extracts ToUnicode mappings for accurate text retrieval, even with malformed data. - Tags: deep-dive - Published: 2026-09-01 ### [How pdf‑inspector Handles CJK and RTL Text: Complete Implementation Guide](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-cjk-and-rtl-text) Learn how pdf-inspector expertly handles CJK and RTL text with Unicode checks, direction-aware sorting, and visual-order glyph run fixing in this implementation guide. - Tags: how-to-guide - Published: 2026-09-01 ### [What Is the MAX_COLUMNS Limit in pdf-inspector? Understanding the 25-Column Cap](/firecrawl/pdf-inspector/what-is-the-max_columns-limit-in-pdf-inspector) Discover the MAX_COLUMNS limit in pdf-inspector. Learn why the 25-column cap exists and how it optimizes performance for wide tables. - Tags: deep-dive - Published: 2026-09-01 ### [How pdf-inspector Detects Columns in PDFs: A Deep Dive into the Layout Analysis Engine](/firecrawl/pdf-inspector/how-does-pdf-inspector-detect-columns-in-pdfs) Discover how pdf-inspector detects columns in PDFs. Learn about its layout analysis engine using histogram construction, valley detection, and XY-cut fallback for accurate results. - Tags: deep-dive - Published: 2026-09-01 ### [How Heuristic Table Detection Works in pdf‑inspector: A Deep Dive into Text‑Based PDF Table Extraction](/firecrawl/pdf-inspector/how-does-heuristic-table-detection-work-in-pdf-inspector) Discover how heuristic table detection in pdf-inspector extracts tables from PDFs using text analysis. Learn about its nine-stage pipeline for accurate results. - Tags: deep-dive - Published: 2026-09-01 ### [How Line-Based Table Detection Works in pdf-inspector: A Complete Technical Guide](/firecrawl/pdf-inspector/how-does-line-based-table-detection-work-in-pdf-inspector) Explore how pdf-inspector's line-based table detection works. Discover the technical guide to extracting tables with PDF path operators using merging, grouping, and splitting strategies. - Tags: deep-dive - Published: 2026-09-01 ### [How Rect‑Based Table Detection Works in pdf‑inspector: A Deep Dive into PDF Rectangle Operators](/firecrawl/pdf-inspector/how-does-rect-based-table-detection-work-in-pdf-inspector) Discover how pdf-inspector performs rect-based table detection by clustering PDF rectangle operators. Learn about its multi-stage pipeline for accurate table reconstruction. - Tags: deep-dive - Published: 2026-09-01 ### [How pdf-inspector Handles Table Detection Strategies: Three Complementary Pipelines Explained](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-table-detection-strategies) Discover how pdf-inspector uses three prioritized table detection strategies rectangle line-based and heuristic text-only analysis to accurately extract tables from PDFs. - Tags: deep-dive - Published: 2026-09-01 ### [How pdf-inspector Handles Mixed PDF Reclassification: A Technical Deep Dive](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-mixed-pdfs-reclassification) Discover how pdf-inspector tackles mixed PDF reclassification by automatically upgrading documents to Scanned type when text quality is poor, ensuring OCR fallback for usable content recovery. - Tags: deep-dive - Published: 2026-09-01 ### [How pdf-inspector Detects Tiled-Scan PDFs: OAR Escalation Heuristics Explained](/firecrawl/pdf-inspector/how-does-pdf-inspector-detect-tiled-scan-pdfs) Learn how pdf-inspector identifies tiled-scan PDFs using OCR text box analysis and region density heuristics. Discover the trigger for higher-resolution re-rendering. - Tags: internals - Published: 2026-09-01 ### [PDF Classification Types in pdf-inspector: TextBased, Scanned, ImageBased, and Mixed Explained](/firecrawl/pdf-inspector/what-are-the-different-pdf-classification-types-in-pdf-inspector) Discover PDF classification types in pdf-inspector: TextBased, Scanned, ImageBased, and Mixed. Understand how pdf-inspector analyzes your PDFs for efficient data extraction. - Tags: deep-dive - Published: 2026-09-01 ### [How to Debug PDF Classification with RUST_LOG in pdf-inspector](/firecrawl/pdf-inspector/how-to-debug-pdf-classification-with-rust_log) Debug PDF classification in pdf-inspector by setting RUST_LOG. Get structured debug output to stderr, preserving normal program output. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Get Detailed PDF Analysis with JSON Output from detect-pdf](/firecrawl/pdf-inspector/how-to-get-detailed-analysis-with-json-output-from-detect-pdf) Get detailed PDF analysis with JSON output using detect-pdf. Use --json and --analyze flags to extract structured data and layout metadata like tables and columns. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Use the `detect-pdf` CLI for PDF Classification](/firecrawl/pdf-inspector/how-to-use-detect-pdf-cli-for-pdf-classification) Easily classify PDFs with the detect-pdf CLI. Learn how this tool categorizes documents into TextBased, Scanned, or Mixed using simple heuristics. Improve your PDF handling today. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Debug PDF Extraction Layout with RUST_LOG in firecrawl/pdf-inspector](/firecrawl/pdf-inspector/how-to-debug-pdf-extraction-layout-with-rust_log) Debug PDF extraction layout with RUST_LOG in firecrawl/pdf-inspector. Set RUST_LOG to trace column detection, validation failures, and fallback paths in real-time via stderr. - Tags: debugging-guide - Published: 2026-09-01 ### [How to Get Structured JSON Output from pdf2md: A Complete Guide](/firecrawl/pdf-inspector/how-to-get-structured-json-output-from-pdf2md) Unlock structured JSON output from pdf2md easily. Learn to use the --json and --items-json flags for complete metadata or positioned text extraction. Get your data now. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Use the pdf2md CLI for Fast PDF Text Extraction](/firecrawl/pdf-inspector/how-to-use-pdf2md-cli-for-text-extraction) Quickly extract text from PDFs using the pdf2md CLI tool. Convert PDFs to Markdown or JSON effortlessly, supporting OCR for scanned documents. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Install Firecrawl pdf‑inspector: 5 Methods for Python, Node.js, Rust, WebAssembly, and CLI](/firecrawl/pdf-inspector/how-to-install-firecrawl-pdf-inspector) Install firecrawl pdf-inspector using 5 methods: pip, npm, cargo, WebAssembly, and CLI. Access native Rust core library bindings for your Python, Node.js, or Rust project. - Tags: getting-started - Published: 2026-09-01 ### [How pdf-inspector Detects Reading Order: A Deep Dive into Image-Anchored Flow Logic](/firecrawl/pdf-inspector/what-is-reading-order-detection-logic-in-pdf-inspector) Discover how pdf-inspector detects reading order using image-anchored flow logic. Learn about its topological region graph and accurate text sequencing for PDFs. - Tags: deep-dive - Published: 2026-08-31 ### [How to Load a PDF Document from Memory in pdf-inspector](/firecrawl/pdf-inspector/how-to-load-pdf-document-from-memory-in-pdf-inspector) Learn to load PDF documents directly from memory using pdf-inspector's *_mem APIs. Process PDFs efficiently without filesystem I/O. Explore byte slice processing for seamless integration. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Load a PDF Document from a File Path in pdf‑inspector](/firecrawl/pdf-inspector/how-to-load-pdf-document-from-file-path-in-pdf-inspector) Learn to load PDF documents from a file path using pdf-inspector's process_pdf function. Get structured Markdown and metadata for your PDFs easily. - Tags: how-to-guide - Published: 2026-08-31 ### [pdf-inspector Performance Benchmarks: Speed-First PDF Processing Explained](/firecrawl/pdf-inspector/what-are-performance-benchmarks-for-pdf-inspector) Discover pdf-inspector performance benchmarks. Experience lightning-fast PDF processing at 2.35ms per document, achieving 400 PDFs/sec without OCR. Optimize your workflows now. - Tags: performance - Published: 2026-08-31 ### [How to Configure pdf-inspector Processing Options: A Complete Guide](/firecrawl/pdf-inspector/how-to-configure-pdf-inspector-processing-options) Master pdf-inspector processing options with the PdfOptions builder. Easily configure mode, pagination, decryption, OCR, tables, and markdown output for efficient document analysis. - Tags: how-to-guide - Published: 2026-08-31 ### [PDF-to-Markdown Conversion Options in pdf-inspector: Complete Configuration Guide](/firecrawl/pdf-inspector/what-are-markdown-conversion-options-in-pdf-inspector) Explore pdf-inspector's Markdown conversion options. Configure profiles, page numbers, images, and tables for precise PDF to Markdown transformation. Learn more. - Tags: how-to-guide - Published: 2026-08-31 ### [How pdf-inspector Converts Extracted PDF Text to Markdown: A 4-Stage Pipeline Explained](/firecrawl/pdf-inspector/how-does-pdf-inspector-convert-extracted-text-to-markdown) Discover how pdf-inspector converts extracted PDF text to Markdown through a 4-stage pipeline. Learn about document type detection, layout analysis, element classification, and token streaming for clean, hierarchical Markdown. - Tags: deep-dive - Published: 2026-08-31 ### [How pdf-inspector Detects Tables in PDFs: A Complete Technical Guide](/firecrawl/pdf-inspector/how-does-pdf-inspector-detect-tables-in-pdfs) Discover how pdf-inspector detects tables in PDFs using rectangle line and heuristic pipelines Learn about its validation process for accurate table extraction and analysis - Tags: deep-dive - Published: 2026-08-31 ### [How pdf-inspector Merges Fragmented Text Items: A Deep Dive into the Heuristic Table Detector](/firecrawl/pdf-inspector/how-does-pdf-inspector-merge-fragmented-text-items) Discover how pdf-inspector merges fragmented text items. Learn about glyph grouping, sorting, and heuristic combination for accurate text reconstruction. Optimize your document parsing. - Tags: deep-dive - Published: 2026-08-31 ### [What is the TextItem Structure in pdf-inspector? Complete Field Reference](/firecrawl/pdf-inspector/what-is-textitem-structure-in-pdf-inspector) Explore the TextItem structure in pdf-inspector. Understand its fields for position, typography, and semantic flags, crucial for PDF text extraction to Markdown. - Tags: api-reference - Published: 2026-08-31 ### [How pdf-inspector Resolves CMaps and Font Information: A Deep Dive into PDF Text Extraction](/firecrawl/pdf-inspector/how-does-pdf-inspector-resolve-cmap-and-font-information) Learn how pdf-inspector effectively resolves CMaps and font information for accurate PDF text extraction. It prioritizes embedded ToUnicode data and repairs mismatches. - Tags: deep-dive - Published: 2026-08-31 ### [How pdf-inspector Handles PDF Operator States: A Deep Dive into the Rust State Machine](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-pdf-operator-states) Explore how pdf-inspector manages PDF operator states with a Rust state machine. Learn about stack operations and matrix transformations in this deep dive. - Tags: deep-dive - Published: 2026-08-31 ### [How pdf-inspector Extracts Text from PDF Content Streams: A Deep Dive into Its State-Machine Parser](/firecrawl/pdf-inspector/how-does-pdf-inspector-extract-text-from-pdf-content-streams) Learn how pdf-inspector extracts text from PDF content streams using a state-machine parser. Discover its glyph ID mapping and positional metadata for accurate text extraction. - Tags: deep-dive - Published: 2026-08-31 ### [PDF-Inspector OCR Reasons: Complete Guide to When and Why OCR Triggers](/firecrawl/pdf-inspector/what-are-ocr-reasons-in-pdf-inspector) Discover PDF-Inspector OCR reasons. Learn when and why OCR triggers for unreliable text extraction with our complete guide. Understand the 7 defined reasons for accurate document analysis. - Tags: deep-dive - Published: 2026-08-31 ### [How to Change the PDF Classification Strategy in pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/how-to-change-pdf-classification-strategy-in-pdf-inspector) Learn how to change the PDF classification strategy in pdf-inspector. This guide shows you how to create a custom DetectionConfig for precise PDF type detection using ScanStrategy variants. - Tags: how-to-guide - Published: 2026-08-31 ### [How pdf-inspector Classifies PDFs: Architecture, Configuration, and Code Examples](/firecrawl/pdf-inspector/how-does-pdf-inspector-perform-pdf-classification) Learn how pdf-inspector classifies PDFs efficiently by sampling pages and counting text operators. Explore its architecture, configuration, and code examples for TextBased, Scanned, ImageBased, or Mixed documents. - Tags: architecture - Published: 2026-08-31 ### [How to Use pdf-inspector CLI Tools: Complete Installation and Usage Guide](/firecrawl/pdf-inspector/how-to-use-pdf-inspector-cli-tools) Install pdf-inspector CLI tools and master pdf2md for PDF-to-Markdown conversion and detect-pdf for PDF classification. Get the complete installation and usage guide. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Use pdf‑inspector WebAssembly: A Complete Guide to Browser‑Native PDF Processing](/firecrawl/pdf-inspector/how-to-use-pdf-inspector-webassembly) Learn how to use pdf-inspector WebAssembly for client-side PDF processing directly in your browser. Analyze PDFs without server uploads with this complete guide. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Use the `@firecrawl/pdf-inspector` Node.js Bindings: Complete Guide](/firecrawl/pdf-inspector/how-to-use-pdf-inspector-node-js-bindings) Master the @firecrawl/pdf-inspector Node.js bindings. This guide shows how to leverage the powerful Rust PDF engine via TypeScript/JavaScript for fast sync and async PDF processing. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Use the pdf-inspector Rust API: Complete Guide with Examples](/firecrawl/pdf-inspector/how-to-use-pdf-inspector-rust-api) Master the pdf-inspector Rust API to convert PDFs to Markdown or build custom extraction pipelines with process_pdf and region-based functions. Get started now. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Install pdf‑inspector: Complete Guide for Rust, Python, Node.js, and WebAssembly](/firecrawl/pdf-inspector/how-to-install-pdf-inspector) Install pdf-inspector for Rust, Python, or Node.js. Our guide provides simple installation steps for each platform, leveraging pre-built binaries from the core Rust library. - Tags: getting-started - Published: 2026-08-31 ### [How Per‑Page OCR Routing Works with `pagesNeedingOcr` in PDF‑Inspector](/firecrawl/pdf-inspector/pdf-inspector-per-page-ocr-routing) Optimize OCR costs with PDF-Inspector's per-page OCR routing. Learn how pagesNeedingOcr intelligently identifies and processes only the essential pages for OCR extraction. - Tags: how-to-guide - Published: 2026-08-14 ### [How Font Width Tables, CMapDecisionCache, and TrueType CMap Fallback Contribute to Font Decoding in PDF-Inspector](/firecrawl/pdf-inspector/pdf-inspector-font-decoding-mechanisms) Discover how PDF-Inspector decodes fonts using font width tables, CMapDecisionCache, and TrueType cmap fallback for accurate glyph positioning and Unicode mapping. - Tags: internals - Published: 2026-08-14 ### [How pdf-inspector Extracts Form XObject Text and Image Placeholders from PDF Content Streams](/firecrawl/pdf-inspector/pdf-inspector-form-xobject-text-image-extraction) Learn how pdf-inspector extracts Form XObject text and image placeholders from PDF content streams. It uses a state machine and the Do operator for efficient PDF content analysis. - Tags: how-to-guide - Published: 2026-08-14 ### [pdf2md CLI Options Explained: `--json`, `--items-json`, `--compact`, `--pages`, and `--select-pages`](/firecrawl/pdf-inspector/pdf2md-cli-options-explained) Master pdf2md CLI options like --json, --items-json, --compact, --pages, and --select-pages. Customize PDF to Markdown extraction with structured output and page control. - Tags: api-reference - Published: 2026-08-14 ### [pdf-inspector vs LiteParse, OpenDataLoader & PyMuPDF4LLM: Benchmark Comparison on TEDS, MHS, and NID Scores](/firecrawl/pdf-inspector/pdf-inspector-benchmark-comparison-liteparse-open-dataloader-pymupdf4llm) Discover how pdf-inspector outperforms LiteParse OpenDataLoader and PyMuPDF4LLM in semantic quality and speed according to TEDS MHS and NID benchmark scores. See the full comparison. - Tags: benchmark-comparison - Published: 2026-08-14 ### [How PDF-Inspector Avoids Redundant I/O Between Detection and Extraction Stages](/firecrawl/pdf-inspector/pdf-inspector-single-document-load-io-optimization) Learn how PDF-Inspector prevents redundant I/O by using a single in-memory lopdf::Document shared between detection and extraction for efficient PDF processing. - Tags: internals - Published: 2026-08-14 ### [How pdf-inspector Manages Encrypted and Password-Protected PDF Documents](/firecrawl/pdf-inspector/pdf-inspector-handling-encrypted-password-pdfs) Learn how pdf-inspector manages encrypted and password-protected PDFs. Discover its secure handling of passwords, automatic fallbacks, and redacted logging for enhanced security. - Tags: how-to-guide - Published: 2026-08-14 ### [OCR Reason Codes in pdf‑inspector: suspected_garbled_text, scanned, no_text, vector_text Explained](/firecrawl/pdf-inspector/pdf-inspector-ocr-reason-codes) Understand pdf-inspector OCR reason codes like suspected_garbled_text, scanned, no_text, and vector_text. Learn why your PDF needs OCR for accurate text extraction. - Tags: deep-dive - Published: 2026-08-14 ### [How pdf-inspector Handles CJK and RTL Text: Ligature Expansion and NFKC Normalization Explained](/firecrawl/pdf-inspector/pdf-inspector-cjk-rtl-text-handling) Discover how pdf-inspector expertly handles CJK and RTL text with NFKC normalization and ligature expansion for accurate, searchable results. Learn about its advanced text processing. - Tags: deep-dive - Published: 2026-08-14 ### [How pdf-inspector's Markdown Converter Detects Headings, Bold/Italic Text, Lists, Code Blocks, and URLs](/firecrawl/pdf-inspector/pdf-inspector-markdown-converter-features) Discover how pdf-inspectors Markdown converter identifies headings bold italic text lists code blocks and URLs using advanced font analysis visual cues and Rust modules. - Tags: internals - Published: 2026-08-14 ### [How `extract_tables_in_regions_mem` Performs Region‑Based Table Detection with Markdown Output](/firecrawl/pdf-inspector/pdf-inspector-extract_tables_in_regions_mem-region-table-detection) Learn how extract_tables_in_regions_mem detects tables in specific PDF regions using a 14-stage pipeline and outputs clean Markdown pipe-tables. Explore its advanced validation and quality gates. - Tags: deep-dive - Published: 2026-08-14 ### [How `extract_pages_markdown_mem` Enables Per-Page Extraction with Hybrid OCR Routing in PDF Inspector](/firecrawl/pdf-inspector/pdf-inspector-extract_pages_markdown_mem-per-page-ocr) Learn how extract_pages_markdown_mem in pdf-inspector unlocks per page markdown extraction with hybrid OCR routing for reliable text quality. - Tags: internals - Published: 2026-08-14 ### [How Tagged PDF Support in pdf‑inspector Uses Structure Tree Roles vs Font‑Size Heuristics](/firecrawl/pdf-inspector/pdf-inspector-tagged-pdf-structure-roles-vs-heuristics) Learn how pdf-inspector uses PDF Structure Tree roles over font-size heuristics for accurate semantic PDF extraction. Prioritizes H1-H6, P, L, Code tags. - Tags: deep-dive - Published: 2026-08-14 ### [Garbage Text Upgrade in Firecrawl PDF‑Inspector: How Mixed PDFs Become Scanned PDFs](/firecrawl/pdf-inspector/pdf-inspector-garbage-text-upgrade-reclassification) Learn about Firecrawl PDF-Inspector's garbage text upgrade. Discover how it converts Mixed PDFs to Scanned PDFs using OCR when alphanumeric text is below 50% for better data extraction. - Tags: deep-dive - Published: 2026-08-14 ### [How Tiled-Scan Detection Identifies JBIG2 and Strip-Image PDFs in PDF Inspector](/firecrawl/pdf-inspector/pdf-inspector-tiled-scan-detection-large-images) Learn how tiled-scan detection in PDF Inspector identifies JBIG2 and strip-image PDFs by aggregating pixel areas over 2 million, flagging documents with low large tile counts. - Tags: deep-dive - Published: 2026-08-14 ### [How ToUnicode CMap Parsing Decodes CID-Encoded Fonts (Type0 and Identity-H) in pdf-inspector](/firecrawl/pdf-inspector/pdf-inspector-tounicode-cmap-cid-font-decoding) Learn how ToUnicode CMap parsing decodes CID-encoded fonts like Type0 and Identity-H. Discover the process of converting CID fonts to Unicode in pdf-inspector. - Tags: deep-dive - Published: 2026-08-14 ### [How pdf-inspector Uses Horizontal Projection Histograms and Valley Detection for Column Detection](/firecrawl/pdf-inspector/pdf-inspector-column-detection-histogram-valley) Discover how pdf-inspector detects columns using horizontal projection histograms and valley detection. Analyze page layouts efficiently with this technical approach. - Tags: internals - Published: 2026-08-14 ### [How pdf-inspector Detects Encoding Issues and Triggers OCR Fallback](/firecrawl/pdf-inspector/pdf-inspector-encoding-issues-and-ocr-fallback) Learn how pdf-inspector uses advanced heuristics like Unicode replacement and statistical analysis to detect encoding errors and trigger OCR fallback for corrupted pages. - Tags: how-to-guide - Published: 2026-08-14 ### [Understanding the Three‑Stage Table Detection Process in pdf‑inspector](/firecrawl/pdf-inspector/pdf-inspector-three-stage-table-detection-process) Explore the three-stage table detection process in pdf-inspector: rect-based, line-based, and heuristic. Learn how pdf-inspector prioritizes geometric certainty for accurate table extraction. - Tags: deep-dive - Published: 2026-08-14 ### [PDF‑Inspector ScanStrategy Options Explained: EarlyExit, Full, Sample, and Pages](/firecrawl/pdf-inspector/pdf-inspector-scanstrategy-options-and-usage) Explore pdf-inspector ScanStrategy options: EarlyExit, Full, Sample, and Pages. Choose the best strategy for speed, accuracy, or page control in your PDF analysis. - Tags: deep-dive - Published: 2026-08-14 ### [Understanding the pdf-inspector Processing Pipeline Architecture: A Deep Dive into the 6-Stage Rust Implementation](/firecrawl/pdf-inspector/architecture-pdf-inspector-processing-pipeline) Explore the 6-stage Rust architecture of the pdf-inspector processing pipeline. Discover how it detects PDF types extracts text analyzes layouts and converts content to Markdown. - Tags: architecture - Published: 2026-08-13 ### [How pdf-inspector Converts Extracted Text to Structured Markdown](/firecrawl/pdf-inspector/how-pdf-inspector-converts-extracted-text-to-markdown) Discover how pdf-inspector converts extracted text to structured Markdown. Learn about its four-stage pipeline for headings, lists, tables, and images. - Tags: how-to-guide - Published: 2026-08-13 ### [How to Configure pdf-inspector Processing Options: A Complete Guide to PdfOptions and MarkdownOptions](/firecrawl/pdf-inspector/configure-pdf-inspector-processing-options) Configure pdf-inspector processing options using PdfOptions for extraction modes page ranges OCR and MarkdownOptions for image embedding links and formatting. Master your PDF data extraction. - Tags: how-to-guide - Published: 2026-08-13 ### [PDF Type Detection Strategies in firecrawl/pdf-inspector: Implementation and Usage](/firecrawl/pdf-inspector/pdf-type-detection-strategies-pdf-inspector) Discover PDF type detection strategies in firecrawl/pdf-inspector. Learn how ScanStrategy classifies PDFs as TextBased, Scanned, ImageBased, or Mixed for efficient analysis. Explore implementation and usage. - Tags: deep-dive - Published: 2026-08-13 ### [How to Perform OCR on Specific Pages When pdf‑inspector Detects Them as Scanned](/firecrawl/pdf-inspector/ocr-specific-pages-if-pdf-inspector-detects-scanned) Learn how to perform OCR on specific pages with pdf-inspector. Optimize your workflow by running OCR only on scanned pages, saving time and resources. - Tags: how-to-guide - Published: 2026-08-13 ### [Does pdf-inspector Support CJK and RTL Text Extraction? A Technical Deep Dive](/firecrawl/pdf-inspector/pdf-inspector-cjk-and-rtl-text-support) pdf-inspector excels at CJK and RTL text extraction. Discover how its Unicode detection and layout heuristics ensure accurate multilingual data extraction for your projects. - Tags: deep-dive - Published: 2026-08-13 ### [How pdf-inspector Handles CMap and ToUnicode Parsing for Font Decoding](/firecrawl/pdf-inspector/pdf-inspector-cmap-and-tounicode-parsing) Discover how pdf-inspector decodes fonts using a four-tier fallback strategy for CMap and ToUnicode parsing. Learn about CID to Unicode conversion in our latest technical breakdown. - Tags: deep-dive - Published: 2026-08-13 ### [What Encoding Issues Does pdf-inspector Detect in PDFs?](/firecrawl/pdf-inspector/pdf-inspector-encoding-issue-detection) pdf-inspector finds three key PDF text extraction encoding issues: Unicode replacement characters, dollar-sign-as-space artifacts, and garbled text from character offset errors. Improve your PDF data accuracy. - Tags: deep-dive - Published: 2026-08-13 ### [How to Extract Semantic Structure from Tagged PDFs Using pdf‑inspector](/firecrawl/pdf-inspector/extract-semantic-structure-tagged-pdfs-pdf-inspector) Extract semantic structure from tagged PDFs with pdf-inspector. Map headings, paragraphs, tables, and figures to text content. Convert PDFs to structured Markdown or JSON easily. - Tags: how-to-guide - Published: 2026-08-13 ### [How pdf-inspector Supports Tagged PDFs and Structure Tree Extraction](/firecrawl/pdf-inspector/pdf-inspector-tagged-pdf-structure-tree-extraction) pdf-inspector extracts tagged PDF structure trees, converting semantic tags like H1 and P into Markdown. Preserve logical document hierarchy and accessibility. - Tags: deep-dive - Published: 2026-08-13 ### [How to Extract Tables from Specific Regions of a PDF Page Using pdf-inspector](/firecrawl/pdf-inspector/extract-tables-specific-regions-pdf-page-pdf-inspector) Extract tables from specific PDF regions using pdf-inspector. Learn how to precisely target areas on a page and get structured Markdown output for each bounding box. - Tags: how-to-guide - Published: 2026-08-13 ### [How to Extract Text from Specific Regions of a PDF Page Using pdf-inspector](/firecrawl/pdf-inspector/extract-text-specific-regions-pdf-page-pdf-inspector) Extract text from specific PDF regions using pdf-inspector a fast pure-Rust API. It automatically flags content needing OCR fallback for efficient data retrieval. - Tags: how-to-guide - Published: 2026-08-13 ### [How to Perform Detection-Only Analysis on a PDF with pdf-inspector](/firecrawl/pdf-inspector/detection-only-analysis-pdf-pdf-inspector) Learn how to perform detection-only analysis on a PDF using pdf-inspector. Classify PDFs into TextBased, Scanned, ImageBased, or Mixed types without running layout extraction. - Tags: how-to-guide - Published: 2026-08-13 ### [How to Process PDF Content from Memory with pdf-inspector](/firecrawl/pdf-inspector/process-pdf-content-from-memory-byte-buffer) Easily process PDF content from memory using pdf-inspector's in-memory functions. Parse raw byte buffers directly without saving to disk for efficient PDF processing. - Tags: how-to-guide - Published: 2026-08-13 ### [How to Handle Password-Protected PDFs with pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/handle-password-protected-pdfs-pdf-inspector) Easily handle password-protected PDFs with pdf-inspector. Learn how to pass passwords using PdfOptions for seamless decryption in this complete guide. - Tags: how-to-guide - Published: 2026-08-13 ### [How to Process Only Specific Pages of a PDF with pdf-inspector](/firecrawl/pdf-inspector/process-specific-pdf-pages-pdf-inspector) Easily process specific PDF pages with pdf-inspector. Learn how to use the pages option in PdfOptions or the --pages flag in the pdf2md CLI for targeted PDF processing. - Tags: how-to-guide - Published: 2026-08-13 ### [How pdf-inspector Analyzes Column Layouts in PDF Documents: Histogram-Based Detection in Rust](/firecrawl/pdf-inspector/how-pdf-inspector-analyzes-column-layouts) Learn how pdf-inspector analyzes PDF column layouts using histogram detection and geometric analysis. Discover its Rust implementation for accurate text reconstruction and reading order. - Tags: deep-dive - Published: 2026-08-13 ### [How to Extract Tables from PDFs Using pdf-inspector: 3 Detection Methods Explained](/firecrawl/pdf-inspector/how-to-extract-tables-from-pdfs-using-pdf-inspector) Extract tables from PDFs with pdf-inspector using rectangle clustering, line analysis, or heuristic text patterns. Get structured Markdown or JSON output easily. - Tags: how-to-guide - Published: 2026-08-13 ### [How pdf-inspector Detects Tables in PDFs: A Three-Stage Strategy](/firecrawl/pdf-inspector/pdf-inspector-table-detection-strategies) Discover how pdf-inspector employs a three-stage strategy for accurate table detection in PDFs. Learn about rectangle-based, line-based, and text-flow analysis techniques. - Tags: deep-dive - Published: 2026-08-13 ### [How to Classify a PDF Type Using the pdf-inspector CLI](/firecrawl/pdf-inspector/how-to-classify-pdf-type-using-pdf-inspector-cli) Classify PDF types like TextBased, Scanned, Mixed, or ImageBased using the pdf-inspector CLI. Get human-readable or machine-readable JSON outputs for your documents. - Tags: how-to-guide - Published: 2026-08-13 ### [How does pdf-inspector detect PDF types (TextBased, Scanned, Mixed, ImageBased)](/firecrawl/pdf-inspector/how-pdf-inspector-detects-pdf-types) Discover how pdf-inspector accurately detects PDF types TextBased, Scanned, Mixed, or ImageBased by analyzing content streams and applying a decision tree. Learn more now. - Tags: deep-dive - Published: 2026-08-13 ### [PDF to Markdown Conversion Behavior in pdf-inspector: Default Pipeline Explained](/firecrawl/pdf-inspector/default-pdf-to-markdown-conversion-behavior) Discover the default PDF to Markdown conversion in pdf-inspector. Learn how the Rust pipeline transforms PDFs into structured Markdown quickly and efficiently. - Tags: deep-dive - Published: 2026-08-13 ### [How to Extract Text from PDF to Markdown Using Rust with pdf-inspector](/firecrawl/pdf-inspector/how-to-extract-text-from-pdf-to-markdown-using-rust) Easily extract text from PDF to Markdown with Rust using the pdf-inspector crate. Transform PDFs into clean, token-efficient Markdown with this pure Rust pipeline. - Tags: how-to-guide - Published: 2026-08-13 ### [How to Install the pdf-inspector CLI Tool: A Complete Guide](/firecrawl/pdf-inspector/how-to-install-pdf-inspector-cli-tool) Easily install the pdf-inspector CLI tool with a single cargo command. This guide shows you how to get pdf-inspector up and running quickly for all your PDF inspection needs. - Tags: how-to-guide - Published: 2026-08-13 ### [Why pdf-inspector Parses a PDF Only Once When Loading a Single Document](/firecrawl/pdf-inspector/single-document-load-pdf-parsing) Discover why pdf-inspector parses PDFs only once for single document loads. Learn how it optimizes I/O and ensures consistent decoded state for efficient processing. - Tags: internals - Published: 2026-08-11 ### [How pdf-inspector Performs Text Quality Analysis and Detects Garbage Text/Encoding Issues in Rust](/firecrawl/pdf-inspector/text-quality-analysis-garbage-text-detection) Discover how pdf-inspector analyzes text quality and detects garbage text and encoding issues in Rust using its dual-layer detection system for accurate PDF content. - Tags: deep-dive - Published: 2026-08-11 ### [How pdf-inspector Performs Markdown Conversion: Heading Detection, List Parsing, and Code Blocks](/firecrawl/pdf-inspector/markdown-conversion-pdf-inspector) Discover how pdf-inspector converts PDFs to clean Markdown by analyzing font properties and structural cues for accurate heading detection, list parsing, and code block formatting. - Tags: how-to-guide - Published: 2026-08-11 ### [Hybrid OCR Pipelines in pdf‑inspector: Region‑Based Text Extraction and Layout Models Explained](/firecrawl/pdf-inspector/hybrid-ocr-pipelines-region-based-text-extraction) Explore hybrid OCR pipelines in pdf-inspector. Learn how region-based text extraction and layout models optimize GPU-accelerated OCR for accurate PDF analysis. - Tags: deep-dive - Published: 2026-08-11 ### [How to Detect Encoding Issues and Garbled Text in PDFs Using pdf‑inspector](/firecrawl/pdf-inspector/encoding-issue-detection-garbled-text) Easily detect PDF encoding issues and garbled text with pdf-inspector. Our tool analyzes font encodings, Unicode replacement characters, and CID-font mapping for accurate results. - Tags: how-to-guide - Published: 2026-08-11 ### [How pdf-inspector Detects Multi-Column Layouts: Newspaper vs. Tabular Reading Order Explained](/firecrawl/pdf-inspector/multi-column-layout-detection) Discover how pdf-inspector detects multi-column layouts by analyzing histograms, pre-masking lines, and classifying newspaper vs. tabular reading orders. Get accurate document parsing. - Tags: internals - Published: 2026-08-11 ### [Position-Aware Text Extraction in pdf-inspector: How Font Metrics and Coordinates Preserve PDF Layout](/firecrawl/pdf-inspector/position-aware-text-extraction-font-metrics-coordinates) Discover how pdf-inspector achieves position-aware text extraction using font metrics and coordinates. Learn to preserve PDF layout accurately with our advanced techniques. - Tags: internals - Published: 2026-08-11 ### [ScanStrategy Detection Modes in pdf-inspector: EarlyExit, Full, Sample, and Pages Explained](/firecrawl/pdf-inspector/scanstrategy-detection-modes) Explore ScanStrategy detection modes EarlyExit, Full, Sample, and Pages in pdf-inspector. Choose the best strategy for your PDF analysis needs, balancing speed and accuracy. - Tags: deep-dive - Published: 2026-08-11 ### [How to Detect Specific Pages Needing OCR in Mixed PDFs with pdf-inspector](/firecrawl/pdf-inspector/per-page-ocr-routing-mixed-pdfs) Quickly find pages needing OCR in mixed PDFs with pdf-inspector. This tool precisely identifies and lists pages requiring OCR, streamlining your data extraction process. - Tags: how-to-guide - Published: 2026-08-11 ### [How to Use pdf-inspector for Smart PDF Routing to Avoid OCR Costs](/firecrawl/pdf-inspector/smart-pdf-routing-avoid-ocr-costs) Leverage pdf-inspector to intelligently route PDFs, identifying pages needing OCR before costly inference. Optimize your workflow and save money by processing only essential pages. - Tags: how-to-guide - Published: 2026-08-11 ### [How pdf-inspector Classifies PDF Types: TextBased, Scanned, ImageBased, and Mixed](/firecrawl/pdf-inspector/how-pdf-inspector-classifies-pdf-types) Learn how pdf-inspector classifies PDFs into TextBased, Scanned, ImageBased, and Mixed types. Understand its heuristic decision tree and OCR requirements. - Tags: deep-dive - Published: 2026-08-11 ### [Region-Based Extraction for Layout Model Integration in pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/use-region-based-extraction-layout-model-integration-pdf-inspector) Master region-based extraction in pdf-inspector for precise text, table, and layout data extraction. Seamlessly integrate external layout models and OCR services with this complete guide. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Get Layout Complexity Metadata (Tables & Columns per Page) from pdf‑inspector](/firecrawl/pdf-inspector/get-layout-complexity-metadata-pdf-inspector) Easily get layout complexity metadata, including tables and columns per page, from pdf-inspector. Learn how to use the LayoutComplexity struct with process_pdf() and other functions. - Tags: how-to-guide - Published: 2026-08-10 ### [Handling CID Fonts with ToUnicode CMap Decoding in pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/handle-cid-fonts-unicode-cmap-decoding-pdf-inspector) Learn to extract Unicode text from CID fonts in pdf-inspector using ToUnicode CMap decoding. Our guide covers fallback mechanisms for missing mapping data. - Tags: how-to-guide - Published: 2026-08-10 ### [Detecting and Removing Page Numbers from Extracted Text in pdf‑inspector: A Complete Guide](/firecrawl/pdf-inspector/detect-remove-page-numbers-extracted-text-pdf-inspector) Effortlessly detect and remove page numbers from PDF text extractions using pdf-inspector. Learn how to enable the page number removal feature for cleaner, more accurate results. - Tags: how-to-guide - Published: 2026-08-10 ### [Extracting Hyperlinks from PDFs as Markdown Links Using pdf-inspector](/firecrawl/pdf-inspector/extract-hyperlinks-markdown-links-pdf-inspector) Learn how to extract PDF hyperlinks as Markdown links using pdf-inspector. This tool efficiently parses link annotations and converts them into easy-to-use Markdown syntax. - Tags: how-to-guide - Published: 2026-08-10 ### [Using MarkdownProfile (Fidelity vs Compact) for Token-Efficient Output in pdf-inspector](/firecrawl/pdf-inspector/use-markdownprofile-token-efficient-output-pdf-inspector) Discover how pdf-inspector's Fidelity and Compact MarkdownProfile options reduce tokens efficiently. Preserve exact layout or achieve aggressive token reduction for optimal output. - Tags: deep-dive - Published: 2026-08-10 ### [Handling Password-Protected Encrypted PDFs with pdf-inspector](/firecrawl/pdf-inspector/handle-password-protected-encrypted-pdfs-pdf-inspector) Learn how pdf-inspector effortlessly handles password-protected encrypted PDFs. Discover how to provide passwords and automatically decrypt files for seamless inspection. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Get OCR Recommendations Per Page with Reasons from pdf-inspector](/firecrawl/pdf-inspector/get-ocr-recommendations-per-page-reasons-pdf-inspector) Get per-page OCR recommendations and reasons with pdf-inspector. Use extract_pages_markdown_mem or classify_pdf_mem for clear insights into OCR needs. - Tags: how-to-guide - Published: 2026-08-10 ### [Controlling Pipeline Depth with ProcessMode (DetectOnly, Analyze, Full) in pdf-inspector](/firecrawl/pdf-inspector/control-pipeline-depth-processmode-pdf-inspector) Master pdf-inspector's ProcessMode. Choose DetectOnly, Analyze, or Full to control pipeline depth and optimize PDF to Markdown conversion speed and detail. - Tags: how-to-guide - Published: 2026-08-10 ### [Detecting Vector Grids Inside PDF Regions for TSR-Compatible Processing with pdf-inspector](/firecrawl/pdf-inspector/detect-vector-grids-pdf-regions-tsr-compatible-pdf-inspector) Detect vector grids in PDF regions with pdf-inspector's detect_vector_grid_in_region_mem. Get TSR-compatible tokens and cell bounding boxes efficiently, bypassing file I/O. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Extract Tables from Specific PDF Regions for Hybrid OCR Pipelines Using pdf-inspector](/firecrawl/pdf-inspector/extract-tables-specific-regions-hybrid-ocr-pdf-inspector) Extract tables from specific PDF regions using pdf-inspector. Target areas for table detection and flag regions needing OCR fallback for efficient hybrid OCR pipelines. - Tags: how-to-guide - Published: 2026-08-10 ### [Detecting and Extracting Multi-Column Newspaper Layouts from PDFs with pdf-inspector](/firecrawl/pdf-inspector/detect-extract-multicolumn-layouts-pdf-inspector) Easily detect and extract multi column newspaper layouts from PDFs with pdf inspector. Our pipeline preserves natural reading order without machine learning. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Disable Specific Markdown Conversions (Headers, Lists, Code) Using MarkdownOptions in pdf-inspector](/firecrawl/pdf-inspector/disable-markdown-conversions-markdownoptions-pdf-inspector) Learn to disable specific markdown conversions like headers lists or code in pdf-inspector by setting MarkdownOptions boolean fields detect_headers detect_lists and detect_code to false. - Tags: how-to-guide - Published: 2026-08-10 ### [Processing PDF Files from a Memory Buffer with pdf-inspector](/firecrawl/pdf-inspector/process-pdf-memory-buffer-file-path-pdf-inspector) Process PDFs from memory buffers with pdf-inspector using detect_pdf_type_mem and extract_text_with_positions_mem. Avoid filesystem I/O by parsing bytes directly. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Use ScanStrategy (EarlyExit, Full, Sample, Pages) for Faster PDF Detection in pdf‑inspector](/firecrawl/pdf-inspector/use-scanstrategy-faster-detection-pdf-inspector) Boost PDF detection speed in pdf-inspector using ScanStrategy options like EarlyExit, Full, Sample, and Pages. Optimize performance for your specific needs. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Get X/Y Position Coordinates for Extracted Text in pdf-inspector](/firecrawl/pdf-inspector/get-xy-coordinates-extracted-text-pdf-inspector) Discover how to get X/Y position coordinates for extracted text in pdf-inspector using TextItem structs and extract_text_with_positions functions. Learn PDF point measurements. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Configure Table Detection Strategies in pdf-inspector (Rect-Based vs. Line-Based vs. Heuristic)](/firecrawl/pdf-inspector/configure-table-detection-strategies-pdf-inspector) Master pdf-inspector table detection strategies. Learn to configure rect-based, line-based, and heuristic methods via API or CLI for optimal PDF data extraction. - Tags: how-to-guide - Published: 2026-08-10 ### [Handling PDF Encoding Issues and Garbled Text with pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/handle-pdf-encoding-issues-garbled-text-pdf-inspector) Fix garbled PDF text and encoding issues with pdf-inspector. Learn how this library detects problematic pages and uses OCR fallback for cleaner results. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Extract Text from Specific Bounding Box Regions in PDF Pages with pdf‑inspector](/firecrawl/pdf-inspector/extract-text-specific-bounding-box-pdf-inspector) Easily extract text from specific PDF regions using pdf-inspector's extract_text_in_regions_mem function. Get precise text extraction without rendering, with OCR fallback for quality. - Tags: how-to-guide - Published: 2026-08-10 ### [Extracting Per-Page Markdown from PDFs with pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/extract-per-page-markdown-pdf-inspector) Easily extract per-page Markdown from PDFs using pdf-inspector. Generate JSON output with isolated markdown blocks, tables, and links for each page. Get the complete guide now. - Tags: how-to-guide - Published: 2026-08-10 ### [How to Detect if a PDF Is Text-Based or Scanned Using pdf-inspector](/firecrawl/pdf-inspector/how-to-detect-pdf-text-vs-scanned-pdf-inspector) Quickly detect if a PDF is text-based or scanned using pdf-inspector's detector module. Analyze PDFs in milliseconds for accurate classification. - Tags: how-to-guide - Published: 2026-08-10 ### [How `extract_text_in_regions_mem` Handles Overlapping PDF Regions](/firecrawl/pdf-inspector/how-does-extract_text_in_regions_mem-handle-overlapping-regions) Discover how extract_text_in_regions_mem manages overlapping PDF regions. Learn how it assigns text to the largest overlap area, preventing duplicates and maintaining integrity. - Tags: internals - Published: 2026-08-08 ### [How Vector-Grid Detection Works for Table Extraction in pdf-inspector](/firecrawl/pdf-inspector/how-does-vector-grid-detection-work-for-table-extraction) Discover how pdf-inspector's vector-grid detection extracts tables by analyzing PDF paths and clustering lines into precise cell boundaries for accurate data retrieval. - Tags: internals - Published: 2026-08-08 ### [pdf2md CLI Tool: How to Convert PDFs to Markdown with Custom Flags](/firecrawl/pdf-inspector/how-does-the-cli-tool-pdf2md-work-and-what-are-its-flags) Easily convert PDFs to Markdown with the pdf2md CLI tool. Explore custom flags for JSON output page filtering password protection and layout analysis. Get started today. - Tags: how-to-guide - Published: 2026-08-08 ### [Garbage Text Upgrade Mechanism for Mixed PDFs in pdf-inspector: A Technical Deep Dive](/firecrawl/pdf-inspector/what-is-the-garbage-text-upgrade-mechanism-for-mixed-pdfs) Discover the garbage text upgrade mechanism in firecrawl pdf-inspector. Learn how it reprocesses Mixed PDFs with invisible text layers to improve text extraction and classification. - Tags: deep-dive - Published: 2026-08-08 ### [How PDF-Inspector Detects Newspaper-Style Layouts in PDF Documents](/firecrawl/pdf-inspector/how-does-newspaper-style-layout-detection-work) Discover how PDF-Inspector uses geometry, density ratios, and collision tests to detect newspaper-style layouts in PDFs. Understand text flow analysis for accurate document parsing. - Tags: internals - Published: 2026-08-08 ### [Performance Characteristics of pdf-inspector: How to Optimize for Large PDFs](/firecrawl/pdf-inspector/what-are-the-performance-characteristics-of-pdf-inspector-and-how-to-optimize-for-large-pdfs) Discover pdf-inspector performance benchmarks and optimization tips for large PDFs. Learn how single-pass parsing achieves 2.35ms per document processing. - Tags: performance - Published: 2026-08-08 ### [How to Debug PDF Extraction Issues Using RUST_LOG Environment Variables](/firecrawl/pdf-inspector/how-can-i-debug-extraction-issues-using-rust_log-environment-variables) Debug PDF extraction issues with RUST_LOG environment variables in firecrawl pdf-inspector. Activate module specific logs without recompiling. Get granular insights for faster troubleshooting. - Tags: how-to-guide - Published: 2026-08-08 ### [How PDF-Inspector Handles Tagged PDFs Using the Structure Tree](/firecrawl/pdf-inspector/what-is-the-support-for-tagged-pdfs-and-how-is-the-structure-tree-used) Discover how PDF-Inspector uses the structure tree to process tagged PDFs. Learn how MCIDs and semantic roles enable precise Markdown generation beyond visual cues. - Tags: deep-dive - Published: 2026-08-08 ### [How pdf-inspector Handles Right-to-Left (RTL) Text and CJK Characters](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-right-to-left-rtl-text-and-cjk-characters) Discover how pdf-inspector accurately processes Right-to-Left text and CJK characters using Unicode checks and advanced sorting for precise PDF to Markdown conversion. Ensure correct reading order. - Tags: deep-dive - Published: 2026-08-08 ### [What Is Tiled-Scan Detection? How It Identifies JBIG2 and Strip-Image PDFs](/firecrawl/pdf-inspector/what-is-tiled-scan-detection-and-how-does-it-identify-jbig2-strip-image-pdfs) Learn about tiled-scan detection a powerful algorithm that identifies JBIG2 and strip-image PDFs for accurate text extraction. Understand its role in PDF analysis. - Tags: deep-dive - Published: 2026-08-08 ### [How to Extract Tables from Specific PDF Regions Using `extract_tables_in_regions_mem`](/firecrawl/pdf-inspector/how-does-extract_tables_in_regions_mem-work-for-extracting-tables-in-specific-areas) Learn how extract_tables_in_regions_mem from pdf-inspector extracts tables from specific PDF regions. This function uses line-grid detection to return structured Markdown. - Tags: how-to-guide - Published: 2026-08-08 ### [Region-Based Text Extraction in Hybrid OCR Pipelines: A Technical Guide to pdf-inspector](/firecrawl/pdf-inspector/what-is-region-based-text-extraction-and-how-is-it-used-in-hybrid-ocr-pipelines) Learn about region-based text extraction in hybrid OCR pipelines. This technical guide explains how pdf-inspector processes specific PDF areas for efficient OCR and preserves native text. - Tags: how-to-guide - Published: 2026-08-08 ### [How to Use `extract_pages_markdown_mem` for Per-Page Markdown Extraction](/firecrawl/pdf-inspector/how-to-use-extract_pages_markdown_mem-for-per-page-markdown-extraction) Learn how to use extract_pages_markdown_mem to get per-page Markdown extraction from PDF bytes with OCR routing metadata. Get detailed page results efficiently. - Tags: how-to-guide - Published: 2026-08-08 ### [How to Customize the Markdown Output Format in pdf-inspector](/firecrawl/pdf-inspector/how-can-i-customize-the-markdown-output-format) Customize Markdown output in pdf-inspector using ProcessOptions, CLI JSON output, or by forking the repository. Learn how to tailor your PDF to Markdown conversions for specific needs. - Tags: how-to-guide - Published: 2026-08-08 ### [How CMap and ToUnicode Parsing Works for CID Fonts in pdf‑inspector](/firecrawl/pdf-inspector/how-does-cmap-and-tounicode-parsing-work-for-cid-fonts) Learn how pdf-inspector parses CMap and ToUnicode for CID fonts. It converts CID codes to Unicode strings via embedded streams, TrueType fallback mappings, and glyph ID remapping for accurate text extraction. - Tags: deep-dive - Published: 2026-08-08 ### [How pdf-inspector Detects PDF Encoding Issues: 3 Critical Heuristics Explained](/firecrawl/pdf-inspector/what-kind-of-encoding-issues-does-pdf-inspector-detect) Discover how pdf-inspector detects PDF encoding issues like Unicode replacement, dollar signs, and cipher garbling using 3 critical heuristics. Ensure accurate text extraction. - Tags: deep-dive - Published: 2026-08-08 ### [How pdf-inspector Detects Columns and Layouts in Multi-Column PDFs](/firecrawl/pdf-inspector/how-does-pdf-inspector-detect-columns-and-layouts-in-multi-column-pdfs) Discover how pdf-inspector uses histogram-based geometric analysis to detect columns and layouts in multi-column PDFs. Learn its newspaper and tabular classification methods. - Tags: how-to-guide - Published: 2026-08-08 ### [Table Detection Methods in pdf-inspector: Rectangle, Line, and Heuristic Approaches](/firecrawl/pdf-inspector/what-are-the-different-methods-for-table-detection-in-pdf-inspector) Explore pdf-inspector's table detection methods: rectangle, line, and heuristic. Discover how this tool efficiently extracts tables from PDFs. - Tags: deep-dive - Published: 2026-08-08 ### [How Per-Page OCR Routing Works with `pages_needing_ocr` in PDF Inspector](/firecrawl/pdf-inspector/how-does-per-page-ocr-routing-work-with-pages_needing_ocr) Learn how PDF Inspector optimizes OCR with pages_needing_ocr, routing only image-based pages for efficient text extraction and processing searchable content directly. - Tags: how-to-guide - Published: 2026-08-08 ### [ProcessMode Enum in pdf-inspector: How It Controls PDF Processing Depth](/firecrawl/pdf-inspector/what-is-the-processmode-enum-and-how-does-it-affect-pdf-processing) Learn how the ProcessMode enum in pdf-inspector controls PDF processing depth. Choose between Full, Analyze, and DetectOnly modes for tailored extraction. - Tags: internals - Published: 2026-08-08 ### [How to Process PDFs from Memory Buffer vs File Path in pdf-inspector](/firecrawl/pdf-inspector/how-to-process-pdfs-from-memory-buffer-vs-file-path) Learn how to process PDFs from memory buffer or file path using pdf-inspector. Understand the differences and choose the best method for your needs. Optimize your PDF processing workflow. - Tags: how-to-guide - Published: 2026-08-08 ### [How to Configure Custom PDF Processing Options in pdf-inspector](/firecrawl/pdf-inspector/how-do-i-configure-custom-pdf-processing-options) Learn to configure custom PDF processing options in pdf-inspector. Use the fluent builder API and process_pdf_with_options for advanced control over your PDF analysis. - Tags: how-to-guide - Published: 2026-08-08 ### [ScanStrategy Options in pdf‑inspector: When to Use EarlyExit, Full, Sample, and Pages](/firecrawl/pdf-inspector/what-are-the-scansstrategy-options-and-when-should-i-use-each) Explore pdf-inspector ScanStrategy options like EarlyExit, Full, Sample, and Pages. Learn when to use each strategy to optimize PDF analysis speed and accuracy for your project. - Tags: deep-dive - Published: 2026-08-08 ### [How pdf-inspector Detects PDF Type: TextBased, Scanned, Mixed, and ImageBased Classification](/firecrawl/pdf-inspector/how-does-pdf-inspector-detect-pdf-type-textbased-scanned-mixed-imagebased) Discover how pdf-inspector classifies PDFs as TextBased, Scanned, Mixed, or ImageBased by analyzing content streams and page metrics. Understand your documents faster. - Tags: how-to-guide - Published: 2026-08-08 ### [How to Use Firecrawl PDF-Inspector for Web Scraping PDFs](/firecrawl/pdf-inspector/how-to-use-firecrawl-pdf-inspector-for-web-scraping-pdfs) Learn how to web scrape PDFs with Firecrawl PDF-Inspector. Convert PDFs to clean Markdown, perfect for AI and LLM integration. Get structured data easily. - Tags: how-to-guide - Published: 2026-08-07 ### [Top Firecrawl pdf-inspector Alternatives: 8 PDF Parsing Tools Compared](/firecrawl/pdf-inspector/are-there-alternative-pdf-parsing-tools-to-firecrawl-pdf-inspector) Explore top Firecrawl pdf-inspector alternatives. Compare 8 PDF parsing tools like PyMuPDF, pdfminer.six, and Poppler for OCR, rendering, and ecosystem needs. - Tags: comparison - Published: 2026-08-07 ### [How to Troubleshoot Errors with Firecrawl pdf-inspector: A Complete Debugging Guide](/firecrawl/pdf-inspector/how-to-troubleshoot-errors-with-firecrawl-pdf-inspector) Troubleshoot firecrawl pdf-inspector errors by enabling structured logging and tracing issues to their source module. Quickly diagnose PDF parsing failures with this debugging guide. - Tags: how-to-guide - Published: 2026-08-07 ### [Firecrawl pdf‑inspector Performance on Large PDFs: Benchmarks and Optimization Strategies](/firecrawl/pdf-inspector/what-is-the-performance-of-firecrawl-pdf-inspector-on-large-pdfs) Discover the lightning-fast performance of firecrawl pdf-inspector on large PDFs. Benchmarks show it processes 300 pages in under 200ms. Optimize your workflow today. - Tags: performance - Published: 2026-08-07 ### [How to Extract Images from PDFs Using Firecrawl pdf‑inspector](/firecrawl/pdf-inspector/how-to-extract-images-from-pdfs-using-firecrawl-pdf-inspector) Easily extract images from PDFs with firecrawl pdf-inspector. Learn how to enable the include_images option and get structured image metadata with bounding boxes. - Tags: how-to-guide - Published: 2026-08-07 ### [Does Firecrawl pdf-inspector Support PDF Forms? A Complete Technical Guide](/firecrawl/pdf-inspector/does-firecrawl-pdf-inspector-support-pdf-forms) Discover if Firecrawl pdf-inspector supports PDF forms. Learn how it extracts AcroForm field values into TextItems for seamless markdown conversion. - Tags: how-to-guide - Published: 2026-08-07 ### [How to Configure Firecrawl PDF‑Inspector for Specific Use Cases: Detection, Speed, and Extraction Modes](/firecrawl/pdf-inspector/how-to-configure-firecrawl-pdf-inspector-for-specific-use-cases) Master Firecrawl PDF-Inspector configuration for your specific needs. Learn to optimize detection, speed, and extraction modes with tailored settings for peak performance. - Tags: how-to-guide - Published: 2026-08-07 ### [Firecrawl PDF-Inspector Dependencies: Complete Guide for Native, WASM, and Python Builds](/firecrawl/pdf-inspector/what-are-the-dependencies-for-running-firecrawl-pdf-inspector) Explore Firecrawl PDF-Inspector dependencies for native, WASM, and Python builds. Get a complete guide to setting up your development environment. - Tags: dependencies - Published: 2026-08-07 ### [How to Contribute to the firecrawl pdf-inspector Project: A Complete Developer Guide](/firecrawl/pdf-inspector/how-to-contribute-to-the-firecrawl-pdf-inspector-project) Learn how to contribute to the firecrawl pdf-inspector project. Follow our developer guide to fork, branch, test, and submit your first pull request to enhance the PDF inspection tool. - Tags: how-to-guide - Published: 2026-08-07 ### [Where to Find Documentation for firecrawl/pdf‑inspector: A Complete Guide to the Official Docs](/firecrawl/pdf-inspector/where-can-i-find-the-documentation-for-firecrawl-pdf-inspector) Find official documentation for firecrawl pdf-inspector within the repository README and docs folder. Access guides for Python API, Rust API, debugging, and more. - Tags: how-to-guide - Published: 2026-08-07 ### [Is Firecrawl pdf-inspector Open Source? License, Architecture, and Usage Guide](/firecrawl/pdf-inspector/is-firecrawl-pdf-inspector-open-source) Yes Firecrawl pdf-inspector is open source under the MIT License. Explore its GitHub repository for source code, architecture details, and usage. - Tags: getting-started - Published: 2026-08-07 ### [How to Handle Complex PDF Layouts with Firecrawl pdf‑inspector: A Complete Technical Guide](/firecrawl/pdf-inspector/how-to-handle-complex-pdf-layouts-with-firecrawl-pdf-inspector) Master complex PDF layouts with Firecrawl pdf-inspector. Learn its multi-stage pipeline for classification, parsing, column detection, table extraction, and Markdown generation. Get precise PDF data. - Tags: how-to-guide - Published: 2026-08-07 ### [Firecrawl pdf-inspector Limitations: 9 Known Constraints Explained](/firecrawl/pdf-inspector/what-are-the-limitations-of-firecrawl-pdf-inspector) Discover the limitations of Firecrawl pdf-inspector. Learn about its constraints with scanned PDFs, OCR, table detection, password protection, and parallel processing. - Tags: limitations - Published: 2026-08-07 ### [How to Get Structured Data from PDFs with Firecrawl pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/how-to-get-structured-data-from-pdfs-with-firecrawl-pdf-inspector) Effortlessly extract structured data from PDFs using Firecrawl pdf-inspector. Convert PDFs to Markdown or JSON, automatically classify document types, and process scanned pages with OCR. Get started today! - Tags: how-to-guide - Published: 2026-08-07 ### [How firecrawl pdf-inspector Extracts Tables from PDFs Using Three Detection Strategies](/firecrawl/pdf-inspector/can-firecrawl-pdf-inspector-extract-tables-from-pdfs) Learn how firecrawl pdf-inspector extracts tables from PDFs using rect-based, line-based, and heuristic strategies. Get your data in Markdown format. - Tags: how-to-guide - Published: 2026-08-07 ### [How to Parse PDF Metadata Using firecrawl pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/how-to-parse-pdf-metadata-using-firecrawl-pdf-inspector) Learn to parse PDF metadata with firecrawl pdf-inspector. Easily extract title author subject and creation date using the process_pdf() function for your technical projects. - Tags: how-to-guide - Published: 2026-08-07 ### [Python Libraries for Firecrawl PDF-Inspector: Official PyO3 Bindings Guide](/firecrawl/pdf-inspector/are-there-any-python-libraries-for-firecrawl-pdf-inspector) Explore official Python bindings for Firecrawl PDF-Inspector. Discover how to use the PyO3-built pdf-inspector package for powerful PDF analysis and extraction. - Tags: api-reference - Published: 2026-08-07 ### [How to Integrate firecrawl/pdf-inspector into a Node.js Project](/firecrawl/pdf-inspector/how-to-integrate-firecrawl-pdf-inspector-into-a-node-js-project) Integrate firecrawl pdf-inspector into your Node.js app. Extract Markdown, detect PDF types, and parse tables easily with our async functions. Get started today. - Tags: how-to-guide - Published: 2026-08-07 ### [Programming Languages Supported by Firecrawl PDF‑Inspector: A Complete Guide](/firecrawl/pdf-inspector/what-programming-languages-are-supported-by-firecrawl-pdf-inspector) Explore the programming languages supported by Firecrawl PDF-Inspector including Rust, Python, Node.js, JavaScript, and WebAssembly. Integrate seamlessly with native bindings or the CLI. - Tags: getting-started - Published: 2026-08-07 ### [Does Firecrawl PDF-Inspector Support OCR for Image-Based PDFs?](/firecrawl/pdf-inspector/does-firecrawl-pdf-inspector-support-ocr-for-image-based-pdfs) Firecrawl PDF-Inspector detects image-based PDFs and flags pages needing OCR for external processing. Learn how it handles OCR-requiring documents. - Tags: how-to-guide - Published: 2026-08-07 ### [How firecrawl pdf-inspector Extracts Text from PDFs: A Deep Dive into the Rust Pipeline](/firecrawl/pdf-inspector/how-does-firecrawl-pdf-inspector-extract-text-from-pdfs) Discover how firecrawl pdf-inspector extracts text from PDFs using its Rust pipeline. Learn about state machines CMaps and graphics transformations for accurate text extraction. - Tags: deep-dive - Published: 2026-08-07 ### [How to Use Firecrawl pdf‑inspector for Programmatic PDF Analysis](/firecrawl/pdf-inspector/can-i-use-firecrawl-pdf-inspector-for-programmatic-pdf-analysis) Learn to use Firecrawl pdf-inspector for programmatic PDF analysis. Access native Rust APIs with Python, Node.js, and WebAssembly bindings. Automate your PDF tasks today. - Tags: how-to-guide - Published: 2026-08-07 ### [Firecrawl PDF-Inspector: 10 Core Features for Rust & Python PDF Analysis](/firecrawl/pdf-inspector/what-are-the-main-features-of-firecrawl-pdf-inspector) Explore Firecrawl PDF-Inspector's 10 core features for robust PDF analysis. Get fast text extraction, Markdown conversion, and layout analysis with this Rust and Python library. - Tags: deep-dive - Published: 2026-08-07 ### [How to Install Firecrawl pdf‑inspector Locally: Complete Setup Guide for Rust, Python, Node.js, and CLI](/firecrawl/pdf-inspector/how-to-install-firecrawl-pdf-inspector-locally) Install Firecrawl pdf-inspector locally for CLI Rust Python Nodejs with simple commands. Get powerful PDF inspection without external services. - Tags: getting-started - Published: 2026-08-07 ### [How to Debug PDF Extraction Issues in pdf-inspector Using `RUST_LOG` Environment Variables](/firecrawl/pdf-inspector/pdf-inspector-debug-extraction-rust-log) Debug pdf-inspector extraction issues by setting RUST_LOG environment variables. Trace pipeline problems with module-specific debug levels for accurate content identification. - Tags: how-to-guide - Published: 2026-08-06 ### [How pdf-inspector Handles Vector Text (Path-Operator Text) Versus Actual Text in PDFs](/firecrawl/pdf-inspector/pdf-inspector-vector-text-vs-real-text-handling) Discover how pdf-inspector differentiates vector text from actual text by analyzing path and text operators. It automatically uses OCR for geometric path text. - Tags: internals - Published: 2026-08-06 ### [How to Use `extract_positioned_text_from_doc` to Extract Raw `TextItem` Objects with Coordinates in pdf-inspector](/firecrawl/pdf-inspector/pdf-inspector-extract-positioned-text-raw-items) Learn to extract raw TextItem objects with coordinates using extract_positioned_text_from_doc in pdf-inspector. Get text, coordinates, dimensions, and font details efficiently. - Tags: how-to-guide - Published: 2026-08-06 ### [How pdf‑inspector's Markdown Converter Handles Bullet, Numbered, and Lettered Lists](/firecrawl/pdf-inspector/pdf-inspector-markdown-converter-list-handling) Discover how pdf-inspector's Markdown converter classifies and normalizes bullet, numbered, and lettered lists from PDFs. Learn about its pattern matching in Rust. - Tags: how-to-guide - Published: 2026-08-06 ### [PDF-Inspector Detection Configuration: Tuning min_text_ops_per_page and text_page_ratio_threshold](/firecrawl/pdf-inspector/pdf-inspector-tuning-detection-config-parameters) Tune pdf-inspector detection configuration using min_text_ops_per_page and text_page_ratio_threshold to accurately classify PDFs. Optimize your document analysis. - Tags: how-to-guide - Published: 2026-08-06 ### [How Tagged PDF Structure Tree Parsing Works in pdf-inspector for Semantic Roles (H1-H6, P, Code)](/firecrawl/pdf-inspector/pdf-inspector-tagged-pdf-structure-tree-parsing) Explore how pdf-inspector parses tagged PDF structure trees for semantic roles like H1-H6, P, and Code. Learn how it maps MCIDs to roles for accurate markdown conversion. - Tags: deep-dive - Published: 2026-08-06 ### [How to Use `detect_vector_grid_in_region_mem` for TSR-Compatible Table Structure Detection in pdf-inspector](/firecrawl/pdf-inspector/pdf-inspector-detect-vector-grid-region-mem-tsr-tables) Unlock TSR-compatible table structures with pdf-inspectors detect_vector_grid_in_region_mem. Extract line-based vector grids from PDFs for seamless semantic labeling and markdown conversion. - Tags: how-to-guide - Published: 2026-08-06 ### [How pdf-inspector Handles RTL Text and CJK Character Extraction in PDFs](/firecrawl/pdf-inspector/pdf-inspector-rtl-cjk-text-extraction) Learn how pdf-inspector expertly extracts RTL text and CJK characters, preserving logical reading order with advanced algorithms. Get accurate data extraction today. - Tags: how-to-guide - Published: 2026-08-06 ### [How pdf-inspector Computes Font Statistics to Detect Heading Tiers (H1–H4)](/firecrawl/pdf-inspector/pdf-inspector-font-statistics-heading-tier-detection) Learn how pdf-inspector computes font statistics to detect H1-H4 headings. It analyzes bold text, filters font sizes, and uses ratio heuristics to identify heading tiers. Understand the PDF heading structure. - Tags: how-to-guide - Published: 2026-08-06 ### [Integrating `extract_tables_in_regions_mem` into Hybrid OCR Pipelines with Layout Models in pdf-inspector](/firecrawl/pdf-inspector/pdf-inspector-extract-tables-regions-mem-hybrid-ocr) Integrate extract_tables_in_regions_mem into hybrid OCR pipelines with layout models. Achieve precision table extraction from PDF byte streams using zero-IO memory processing. - Tags: how-to-guide - Published: 2026-08-06 ### [How pdf-inspector Handles Password-Protected Encrypted PDFs in Rust](/firecrawl/pdf-inspector/pdf-inspector-encrypted-pdf-password-handling) Learn how pdf-inspector in Rust handles password-protected encrypted PDFs. Decrypt PDFs with provided or default passwords using its PdfOptions API. - Tags: how-to-guide - Published: 2026-08-06 ### [How to Build the `pdf2md` and `detect-pdf` CLI Tools from Source: A Complete Guide](/firecrawl/pdf-inspector/pdf-inspector-build-cli-tools-source) Learn to build pdf2md and detect-pdf CLI tools from source. This guide covers compiling the firecrawl pdf-inspector Rust project with cargo build --release for optimized binaries. - Tags: how-to-guide - Published: 2026-08-06 ### [How the pdf-inspector Classifier Differentiates Mixed, Scanned, and Image-Based PDF Types](/firecrawl/pdf-inspector/pdf-inspector-pdf-type-classification) Learn how the pdf-inspector classifier differentiates Mixed, Scanned, and ImageBased PDF types by analyzing text operators, image presence, and vector-text cues. Discover the heuristics behind PDF categorization. - Tags: deep-dive - Published: 2026-08-06 ### [Extract Per-Page Markdown with Layout Metadata from PDFs in Memory Using `extract_pages_markdown_mem`](/firecrawl/pdf-inspector/pdf-inspector-extract-pages-markdown-mem-layout) Extract per page markdown from PDFs in memory using `extract_pages_markdown_mem`. Get layout metadata, table/column flags, and OCR needs without saving files. - Tags: how-to-guide - Published: 2026-08-06 ### [When to Expect Encoding Issues with pdf-inspector and When to Fall Back to OCR](/firecrawl/pdf-inspector/pdf-inspector-encoding-issues-ocr-fallback) Learn when pdf-inspector encounters encoding issues like replacement characters or CID-only fonts. Discover when to switch to OCR for reliable text extraction. - Tags: troubleshooting - Published: 2026-08-06 ### [How to Build and Use the Python Bindings for pdf-inspector with PyO3](/firecrawl/pdf-inspector/pdf-inspector-python-bindings-pyo3) Learn to build and use Python bindings for pdf-inspector with PyO3. Compile a native Python extension for CPython 3.8+ using Cargo build or Maturin develop. - Tags: how-to-guide - Published: 2026-08-06 ### [How to Use the `PdfOptions` Builder to Configure ProcessMode, Page Filters, and Passwords in pdf-inspector](/firecrawl/pdf-inspector/pdf-inspector-pdfoptions-builder-configuration) Configure ProcessMode, page filters, and passwords in pdf-inspector using the PdfOptions builder. Easily set processing pipelines, page subsets, and decryption passwords for efficient PDF handling. - Tags: how-to-guide - Published: 2026-08-06 ### [How pdf‑inspector Distinguishes Multi‑Column Newspaper Layouts from Tabular Layouts](/firecrawl/pdf-inspector/pdf-inspector-multi-column-vs-tabular-layout-detection) Discover how pdf-inspector differentiates multi-column newspaper layouts from tabular data using its two-stage detection and classification pipeline. Learn about prose density, fill ratios, and column balance. - Tags: deep-dive - Published: 2026-08-06 ### [How to Process PDFs from a Memory Buffer Using `process_pdf_mem` in pdf-inspector](/firecrawl/pdf-inspector/pdf-inspector-process-pdf-memory-buffer) Learn to process PDFs from memory buffers with pdf_inspector's process_pdf_mem. Get structured detection and extraction results instantly without file I/O. Optimize your PDF handling. - Tags: how-to-guide - Published: 2026-08-06 ### [How pdf-inspector Handles ToUnicode CMap Parsing for CID-Encoded Fonts Like Identity-H](/firecrawl/pdf-inspector/pdf-inspector-unicode-cmap-cid-fonts) Discover how pdf-inspector parses ToUnicode CMaps for CID-encoded fonts like Identity-H. Learn about its fallback strategies for accurate Unicode text recovery. - Tags: internals - Published: 2026-08-06 ### [How to Extract Text from Specific Bounding Box Regions Using `extract_text_in_regions_mem` in pdf-inspector](/firecrawl/pdf-inspector/pdf-inspector-extract-text-specific-regions-mem) Extract text from specific bounding box regions using pdf-inspectors extract_text_in_regions_mem function. Pass PDF bytes and bounding boxes for precise data extraction without file I/O. - Tags: how-to-guide - Published: 2026-08-06 ### [How the pdf-inspector Table Detection Pipeline Prioritizes Rect, Line, and Heuristic Methods](/firecrawl/pdf-inspector/pdf-inspector-table-detection-pipeline-priority) Discover how the pdf-inspector table detection pipeline prioritizes rect, line, and heuristic methods. Learn its smart strategy for accurate table extraction. - Tags: internals - Published: 2026-08-06 ### [Optimal ScanStrategy Configurations for PDF Detection Performance in pdf‑inspector](/firecrawl/pdf-inspector/pdf-inspector-scansstrategy-configuration-performance) Discover optimal ScanStrategy configurations for pdf-inspector detection performance. Choose Sample for balance, Full for accuracy, EarlyExit for speed, or Pages for custom control. - Tags: performance - Published: 2026-08-06 ### [How pdf-inspector Determines If a PDF Is Text-Based or Scanned Without Loading the Entire Document](/firecrawl/pdf-inspector/pdf-inspector-text-vs-scanned-detection-no-load) Discover how pdf-inspector quickly classifies PDFs as text or scanned by analyzing metadata and page samples, avoiding full document loads for faster insights. - Tags: how-to-guide - Published: 2026-08-06 ### [Pre‑Built Docker Images for pdf‑inspector: What You Need to Know](/firecrawl/pdf-inspector/are-there-any-pre-built-docker-images-for-pdf-inspector) Discover if pre-built Docker images exist for firecrawl/pdf-inspector. Learn why you must build your own container from source for this tool. - Tags: getting-started - Published: 2026-08-04 ### [How to Upgrade pdf-inspector to the Latest Version: Complete Guide for Rust, Python, Node.js, and WebAssembly](/firecrawl/pdf-inspector/how-to-upgrade-pdf-inspector-to-the-latest-version) Easily upgrade pdf-inspector to the latest version with our guide. Learn commands for Rust, Python, Node.js, and WebAssembly to keep your tools updated. - Tags: migration-guide - Published: 2026-08-04 ### [What Is the Underlying Technology Used by PDF‑Inspector for PDF Parsing?](/firecrawl/pdf-inspector/what-is-the-underlying-technology-used-by-pdf-inspector-for-pdf-parsing) Discover the Rust crate lopdf powering PDF-Inspector for efficient PDF parsing. Explore its low-level document handling, object lookup, and stream decompression capabilities. - Tags: deep-dive - Published: 2026-08-04 ### [How to Secure Data When Using pdf‑inspector: A Complete Security Guide](/firecrawl/pdf-inspector/how-to-secure-data-when-using-pdf-inspector) Secure your sensitive data with pdf-inspector. Learn how this local PDF processing tool protects your documents through sandboxing and resource limits. Get the complete security guide now. - Tags: security-guide - Published: 2026-08-04 ### [Limitations of pdf-inspector's PDF Analysis: Architecture, Constraints, and Workarounds](/firecrawl/pdf-inspector/what-are-the-limitations-of-pdf-inspectors-pdf-analysis) Discover the limitations of pdf-inspector's PDF analysis. Learn about its architectural constraints, like the 1M operation limit and 25-column cap, and explore available workarounds for faster edge-computing. - Tags: architecture - Published: 2026-08-04 ### [How to Contribute to the pdf-inspector Project: A Complete Guide for Rust Developers](/firecrawl/pdf-inspector/how-to-contribute-to-the-pdf-inspector-project) Learn how to contribute to the pdf-inspector Rust project. This guide covers selecting a task, running tests, and submitting PRs via GitHub for successful contributions. - Tags: how-to-guide - Published: 2026-08-04 ### [Is pdf-inspector Suitable for Large-Scale PDF Processing?](/firecrawl/pdf-inspector/is-pdf-inspector-suitable-for-large-scale-pdf-processing) Discover if pdf-inspector handles large-scale PDF processing. Explore its high-throughput architecture, single-pass loading, and memory-only APIs for efficient, parallel extraction. - Tags: performance - Published: 2026-08-04 ### [How to Troubleshoot Common Issues with pdf-inspector: Complete Diagnostics Guide](/firecrawl/pdf-inspector/how-to-troubleshoot-common-issues-with-pdf-inspector) Troubleshoot pdf-inspector issues with this diagnostics guide. Learn to identify text extraction failures and garbled output using PdfProcessResult flags like has_encoding_issues and pages_needing_ocr. - Tags: how-to-guide - Published: 2026-08-04 ### [Performance Considerations for pdf-inspector: Optimizing High-Speed PDF Processing](/firecrawl/pdf-inspector/what-are-the-performance-considerations-for-pdf-inspector) Discover performance considerations for pdf-inspector. Achieve sub-3ms extraction latency with optimized PDF processing, single-pass loading, and tiered detection. - Tags: performance - Published: 2026-08-04 ### [How pdf-inspector Handles Scanned Documents: Detection and OCR Classification](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-scanned-documents) Discover how pdf-inspector efficiently processes scanned documents. It detects image-only pages, flags them for OCR, and optimizes extraction. - Tags: deep-dive - Published: 2026-08-04 ### [Can pdf-inspector Extract Tables from PDFs? A Complete Technical Guide](/firecrawl/pdf-inspector/can-pdf-inspector-extract-tables-from-pdfs) Learn how pdf-inspector extracts tables from PDFs. Discover its multi-layered detection pipeline combining rectangle, line, and heuristic analysis for diverse layouts. - Tags: how-to-guide - Published: 2026-08-04 ### [How to Extract Metadata from PDFs Using pdf-inspector: A Complete Guide](/firecrawl/pdf-inspector/how-to-extract-metadata-from-pdfs-using-pdf-inspector) Easily extract PDF metadata like title and page count using pdf-inspector. Learn how to call the detect_pdf_type function for quick, efficient metadata retrieval without full text parsing. - Tags: how-to-guide - Published: 2026-08-04 ### [pdf-inspector Output Formats: Markdown, JSON, and Positioned Text Items](/firecrawl/pdf-inspector/what-are-the-output-formats-of-pdf-inspector) Explore pdf-inspector output formats including Markdown, JSON, and positioned text items. Extract data efficiently with its versatile export options. - Tags: api-reference - Published: 2026-08-04 ### [How to Integrate pdf-inspector into a Node.js Project: Complete Setup Guide](/firecrawl/pdf-inspector/how-to-integrate-pdf-inspector-into-a-node-js-project) Integrate pdf-inspector into Node.js easily. Install the npm package for Rust-based PDF classification and Markdown extraction without a local Rust toolchain. Get started now! - Tags: how-to-guide - Published: 2026-08-04 ### [How to Configure pdf-inspector for Specific PDF Analysis Tasks](/firecrawl/pdf-inspector/how-to-configure-pdf-inspector-for-specific-pdf-analysis-tasks) Configure pdf-inspector for specific PDF analysis tasks using the PdfOptions builder. Tailor processing, detection, filtering, decryption, and formatting for precise PDF pipeline control. - Tags: how-to-guide - Published: 2026-08-04 ### [Does pdf-inspector Support OCR for Image-Based PDFs? How the Library Detects Scan Pages](/firecrawl/pdf-inspector/does-pdf-inspector-support-ocr-for-image-based-pdfs) pdf-inspector flags image-based PDFs needing OCR, not performing OCR itself. Get page numbers and reasons for analysis and downstream processing. - Tags: how-to-guide - Published: 2026-08-04 ### [How pdf-inspector Handles Different PDF Layouts: Detection and Extraction Pipeline](/firecrawl/pdf-inspector/how-does-pdf-inspector-handle-different-pdf-layouts) Discover how pdf-inspector's three-stage pipeline handles diverse PDF layouts, from text-based to scanned, for accurate data extraction and structured Markdown output. - Tags: internals - Published: 2026-08-04 ### [PDF Text Extraction Options in pdf-inspector: A Complete Guide to Rust-Powered PDF Parsing](/firecrawl/pdf-inspector/what-are-the-options-for-pdf-text-extraction-in-pdf-inspector) Explore nine PDF text extraction modes in pdf-inspector, a Rust-powered PDF parser. Get coordinate-aware, region-based, table-to-Markdown, and OCR-ready extraction via Python & WASM. - Tags: how-to-guide - Published: 2026-08-04 ### [How to Use the pdf-inspector API for Custom Integrations](/firecrawl/pdf-inspector/how-to-use-pdf-inspector-api-for-custom-integrations) Integrate pdf-inspector API into your projects. Customize PDF processing, text extraction, and Markdown conversion with this powerful Rust and Python interface. - Tags: how-to-guide - Published: 2026-08-04 ### [How to Extract Text from PDFs Using pdf-inspector: A Complete Technical Guide](/firecrawl/pdf-inspector/can-pdf-inspector-extract-text-from-pdfs) Learn how to extract text from PDFs using pdf-inspector. This Rust library offers a complete technical guide to raw text and structured Markdown extraction. - Tags: how-to-guide - Published: 2026-08-04 ### [How pdf-inspector Parses PDF Files: A Technical Deep Dive into the Rust Pipeline](/firecrawl/pdf-inspector/how-does-pdf-inspector-parse-pdf-files) Discover how pdf-inspector parses PDF files using a Rust pipeline for type detection, content extraction with lopdf, and layout processing. Transform PDFs into structured text and Markdown. - Tags: deep-dive - Published: 2026-08-04 ### [Core Dependencies for pdf-inspector: Inside Firecrawl's Rust PDF Parser](/firecrawl/pdf-inspector/what-are-the-core-dependencies-for-pdf-inspector) Discover the core dependencies for pdf-inspector, Firecrawl's Rust PDF parser. Learn about lopdf, ttf-parser, regex, and more for efficient PDF analysis. - Tags: internals - Published: 2026-08-04 ### [How to Install pdf-inspector Locally: Complete Setup Guide for Rust, Python, and Node.js](/firecrawl/pdf-inspector/how-to-install-pdf-inspector-locally) Install pdf-inspector locally with ease using Rust, Python, or Node.js. Follow our complete setup guide for a seamless integration into your development workflow. - Tags: getting-started - Published: 2026-08-04