ExtractPDF4J 2.1.0

[mehulimukherjee]

ExtractPDF4J v2.1.0

We’re excited to announce ExtractPDF4J v2.1.0, a release focused on improving dependency management, documentation, and developer experience.

This release introduces a Bill of Materials (BOM) module and a full MkDocs documentation site, making it significantly easier to adopt ExtractPDF4J in real-world Java applications.

ExtractPDF4J continues to evolve as a production-ready Java library for extracting structured tables from both text-based and scanned PDFs.

---

Highlights

New: ExtractPDF4J BOM

A new extractpdf4j-bom module simplifies dependency management.

Developers can now import a single BOM dependency to ensure all ExtractPDF4J modules stay aligned.

Example (Installation - Using BOM is recommended)

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.github.extractpdf4j</groupId>
      <artifactId>extractpdf4j-bom</artifactId>
      <version>2.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Then simply declare modules without specifying versions:

<dependency>
  <groupId>io.github.extractpdf4j</groupId>
  <artifactId>extractpdf4j-service</artifactId>
</dependency>

---

Project Modules

ExtractPDF4J now provides a clear modular architecture.

Module	Description
extractpdf4j-core	Core extraction engine and shared models
extractpdf4j-service	High-level API for table extraction
extractpdf4j-cli	Command-line interface
extractpdf4j-bom	Centralized dependency management

This modular design enables:

• flexible integration
• clean dependency graphs
• improved maintainability
• enterprise-friendly dependency management

---

Documentation

This release introduces a full documentation site powered by MkDocs.

The docs include:

• installation guide
• CLI usage
• API examples
• OCR tuning
• architecture overview

Documentation site:

https://extractpdf4j.github.io/ExtractPDF4J/

---

Improvements

• Added MkDocs documentation site
• Added Javadocs publishing workflow
• Improved CLI help output and usage examples
• Improved Docker support for multi-module builds
• Added sample PDFs for testing and demos
• Improved README and documentation structure

---

What's Changed

• Adding javadocs.yml to publish javadocs by @mehulimukherjee in Adding javadocs.yml to publish javadocs #51
• Feature/publish javadocs by @mehulimukherjee in Feature/publish javadocs #52
• Fix GitHub Pages permissions for Javadocs by @mehulimukherjee in Fix GitHub Pages permissions for Javadocs #53
• Update README versions for 2.0.0 release by @mehulimukherjee in Update README versions for 2.0.0 release #54
• build: fix Dockerfile to support multi-module project structure by @mkhmik004 in build: fix Dockerfile to support multi-module project structure #60
• Add sample PDFs and update README descriptions by @Igorot113 in Add sample PDFs and update README descriptions #61
• Update: Fixed Markdown formatting for the README file by @Aryan-The-Ghost in Update: Fixed Markdown formatting for the README file #59
• improve CLI help output and add usage examples by @uncaughtx in improve CLI help output and add usage examples #63
• Add full MkDocs documentation site and GitHub Pages deployment workflow by @mehulimukherjee in Add full MkDocs documentation site and GitHub Pages deployment workflow #106
• Docs: add docs development guide, update README and MkDocs CI to v9 by @mehulimukherjee in Docs: add docs development guide, update README and MkDocs CI to v9 #108
• Fix docs deploy workflow action reference for MkDocs Material by @mehulimukherjee in Fix docs deploy workflow action reference for MkDocs Material #109
• Pin MkDocs 1.x dependencies and update docs build workflow by @mehulimukherjee in Pin MkDocs 1.x dependencies and update docs build workflow #110

---

New Contributors

• @mkhmik004 made their first contribution in build: fix Dockerfile to support multi-module project structure #60
• @Igorot113 made their first contribution in Add sample PDFs and update README descriptions #61
• @Aryan-The-Ghost made their first contribution in Update: Fixed Markdown formatting for the README file #59
• @uncaughtx made their first contribution in improve CLI help output and add usage examples #63

---

Community

ExtractPDF4J is an open-source project and contributions are welcome.

If you find the project useful:

⭐ Star the repository
🔁 Share it with your network
🐛 Open issues or contribute improvements

GitHub Repository:

https://github.com/ExtractPDF4J/ExtractPDF4J

---

What's Next

Upcoming improvements planned for future releases:

• advanced table detection improvements
• additional OCR enhancements
• improved CLI capabilities
• enhanced documentation and examples

---

Full Changelog

v2.0.0...v2.1.0

---

This discussion was created from the release ExtractPDF4J 2.1.0.