@opendataloader/pdf 2.5.7 → 2.5.8

package/README.md

@@ -133,6 +133,7 @@ opendataloader_pdf.convert(
 | Non-English scanned PDF | Hybrid + OCR | `pip install "opendataloader-pdf[hybrid]"` | `opendataloader-pdf-hybrid --port 5002 --force-ocr --ocr-lang "ko,en"` | `opendataloader-pdf --hybrid docling-fast file1.pdf file2.pdf folder/` |
 | Mathematical formulas | Hybrid + formula | `pip install "opendataloader-pdf[hybrid]"` | `opendataloader-pdf-hybrid --enrich-formula` | `opendataloader-pdf --hybrid docling-fast --hybrid-mode full file1.pdf file2.pdf folder/` |
 | Charts needing description | Hybrid + picture | `pip install "opendataloader-pdf[hybrid]"` | `opendataloader-pdf-hybrid --enrich-picture-description` | `opendataloader-pdf --hybrid docling-fast --hybrid-mode full file1.pdf file2.pdf folder/` |
+| Nested sections for RAG chunking | Hybrid + heading levels | `pip install "opendataloader-pdf[hybrid]"` | `opendataloader-pdf-hybrid --port 5002 --heading-hierarchy` | `opendataloader-pdf --hybrid docling-fast file1.pdf file2.pdf folder/` |
 | Untagged PDFs needing accessibility | Auto-tagging → Tagged PDF | `pip install opendataloader-pdf` | None needed | `opendataloader-pdf --format tagged-pdf file1.pdf file2.pdf folder/` |
 
 ## Quick Start
@@ -278,6 +279,36 @@ Output in JSON:
 
 > Uses SmolVLM (256M), a lightweight vision model. Custom prompts supported via `--picture-description-prompt`.
 
+### Heading Hierarchy
+
+The layout model labels a region as a section header without a depth, so by default every
+heading comes back at level 1 and subsections sit at the same depth as the document title.
+Flat headings make it hard to tell a section title from a document title when chunking for RAG.
+
+`--heading-hierarchy` infers the depth — from the PDF outline first, then section numbering
+(`1.` → `1.1` → `1.1.1`), then visual style:
+
+```bash
+# Server
+opendataloader-pdf-hybrid --port 5002 --heading-hierarchy
+
+# Client — no extra flag needed
+opendataloader-pdf --hybrid docling-fast file1.pdf file2.pdf folder/
+```
+
+```diff
+  # 3. Methodology
+- # 3.1. Multi-Object Rectification Network
++ ## 3.1. Multi-Object Rectification Network
+- # Abstract
++ ## Abstract
+```
+
+Numbering covers numbered sections; style is what pulls an unnumbered `Abstract` or
+`References` out from under the document title.
+
+Off by default, so existing output is unchanged. Levels are capped at H6.
+
 ### Hancom Data Loader Integration — Coming Soon
 
 Enterprise-grade AI document analysis via [Hancom Data Loader](https://sdk.hancom.com/en/services/1?utm_source=github&utm_medium=readme&utm_campaign=opendataloader-pdf) — customer-customized models trained on your domain-specific documents. 30+ element types (tables, charts, formulas, captions, footnotes, etc.), VLM-based image/chart understanding, complex table extraction (merged cells, nested tables), SLA-backed OCR for scanned documents, and native HWP/HWPX support. Supports PDF, DOCX, XLSX, PPTX, HWP, PNG, JPG. [Live demo](https://livedemo.sdk.hancom.com/en/dataloader?utm_source=github&utm_medium=readme&utm_campaign=opendataloader-pdf)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendataloader/pdf",
-  "version": "2.5.7",
+  "version": "2.5.8",
   "description": "A Node.js wrapper for the opendataloader-pdf Java CLI.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",