# Foxit Conversion SDK v3.1.0

Release Date: 31 March 2026

## Breaking Changes 

### `PDF2WordSettingData` — Parameter change and default value change

Constructor and `Set()` method add a required `max_blank_paragraphs_per_page_bottom` parameter:

```cpp
// v3.0 (4 parameters)
PDF2WordSettingData(bool enable_retain_page_layout,
    bool enable_generate_headers_and_footers,
    bool enable_generate_footnotes_and_endnotes,
    bool enable_generate_page_rendered_break);

// v3.1 (5 parameters)
PDF2WordSettingData(bool enable_retain_page_layout,
    bool enable_generate_headers_and_footers,
    bool enable_generate_footnotes_and_endnotes,
    bool enable_generate_page_rendered_break,
    int max_blank_paragraphs_per_page_bottom);  // new
```

**Action required:** Add the new parameter when using the parameterized constructor or `Set()`. Pass `-1` for unlimited (matching previous behavior). Alternatively, use the default constructor with field assignment.

**Default value change** — `enable_generate_headers_and_footers` changed from `false` to `true`. Code using the default constructor will now generate headers and footers. Set `enable_generate_headers_and_footers = false` explicitly to preserve previous behavior.

### `PDF2PowerPointSettingData` — Parameter change

Constructor and `Set()` method add a required `enable_adapt_to_largest_page` parameter:

```cpp
// v3.0 (1 parameter)
PDF2PowerPointSettingData(bool enable_aggressively_split_sections);

// v3.1 (2 parameters)
PDF2PowerPointSettingData(bool enable_aggressively_split_sections,
    bool enable_adapt_to_largest_page);  // new
```

**Action required:** Add the new parameter. Pass `false` to preserve previous behavior.

### `PDF2ExcelSettingData` — Parameter change

Constructor and `Set()` method add 2 required parameters:

```cpp
// v3.0 (3 parameters)
PDF2ExcelSettingData(String decimal_symbol, String thousands_separator,
    WorkbookSettings workbook_settings);

// v3.1 (5 parameters)
PDF2ExcelSettingData(String decimal_symbol, String thousands_separator,
    WorkbookSettings workbook_settings,
    bool enable_aggressive_table_repair,  // new
    bool include_watermarks);             // new
```

**Action required:** Add 2 new parameters. Pass `true, false` to preserve previous behavior.

### `PDF2OfficeSettingData` — Parameter change

Constructor and `Set()` method add a required `enable_matching_system_fonts` parameter:

```cpp
// v3.0 (9 parameters)
PDF2OfficeSettingData(const wchar_t* metrics_data_folder_path,
    bool enable_ml_recognition, const Range& page_range,
    bool include_pdf_comments,
    const PDF2WordSettingData& word_setting_data,
    const PDF2PowerPointSettingData& power_point_setting_data,
    const PDF2ExcelSettingData& excel_setting_data,
    bool enable_trailing_space, bool include_images);

// v3.1 (10 parameters)
PDF2OfficeSettingData(/* same 9 parameters */,
    bool enable_matching_system_fonts);  // new
```

**Action required:** Add the new parameter. Pass `false` to preserve previous behavior.

### PDF-to-Word default behavior change

PDF-to-Word conversion now preserves document internal navigation links by default. If downstream workflows depend on link-free Word output, verify conversion results after upgrading.

## New Features and Enhancements

### PDF to Office

- Add `enable_matching_system_fonts` parameter to `PDF2OfficeSettingData` for system font matching in PDF-to-Word conversion
- Add `enable_adapt_to_largest_page` parameter to `PDF2PowerPointSettingData` to unify slide size by scaling smaller pages to the largest page dimension
- Add `enable_aggressive_table_repair` and `include_watermarks` parameters to `PDF2ExcelSettingData` to strengthen table structure repair and control whether watermark content is retained in Excel output
- Improve PDF-to-Word conversion to preserve document internal navigation links (TOC, cross-references) by default
- Improve PDF-to-Word conversion performance and reduce memory usage for complex documents
- Improve PDF-to-Word heading recognition accuracy for better Word heading style mapping
- Improve PDF-to-Word paragraph recognition, page break handling, and cross-page table continuity

### Office to PDF

- Add Linux platform support for `Office2PDFSettingData::is_embed_font` font embedding
- Add DOC (Word 97-2003) format support to `Office2PDF::ConvertFromWord`
- Add `e_ErrNotMatchFont` error code for font-missing scenarios in Office-to-PDF conversion

### Platform

- Add Linux ARM64 .NET Core platform support

## Bug Fixes

### PDF to Word

- Fix crash when converting specific PDF files to Word on Linux .NET platform
- Fix conversion failure producing no output file for specific documents
- Fix exception (`0x77574080 ntdll.dll`) in MFC-based projects during PDF-to-Word conversion in Debug x86 mode
- [Linux] Fix incorrect font substitution where Song typeface renders as Hei in converted Word output
- Improve font selection to avoid Segoe UI Light for better cross-application compatibility with WPS Office
- Fix font style loss (e.g., bold) in converted Word documents
- Fix incorrect font size in conversion output causing layout disruption
- Fix extra spaces between characters in paragraph text of converted Word output
- Fix title character overlap in converted Word documents
- Improve layout stability for translation round-trip workflows where longer translated text caused subsequent page disruption
- Fix crop marks at page corners interfering with third-party translation software
- Fix table of contents misalignment in converted Word documents
- Fix layout misalignment in converted Word output for specific files
- Fix PDF headers and footers incorrectly converted as body text instead of Word header/footer sections
- Fix extra line breaks at end of text lines causing layout disruption during translation write-back
- Fix Arabic content loss during PDF-to-Word conversion
- Improve conversion quality for large documents: reduce layout issues, output file size bloat, and excess page count
- Improve cross-application rendering consistency between Microsoft Office and WPS Office
- Fix faded text, abnormal table rendering, content loss, and text overlap for specific files
- Fix table of contents loss or corruption with headings not recognized in converted output
- Fix `enable_generate_headers_and_footers = true` not taking effect in `PDF2WordSettingData`

### PDF to Excel

- Fix cell text placed inside drawing shapes instead of editable cells
- Fix excessive conversion time and incorrect table structure with cells appearing as images
- Fix content loss when converting built-in test documents

### Word to PDF

- Fix crash in `Office2PDF::ConvertFromWord` when converting specific DOCX files
- Fix hang with memory spike to 4 GB when converting specific Word files
- Fix table content loss in specific regions during conversion
- Improve character spacing and paragraph layout fidelity on Windows
- Fix `is_embed_font = true` not taking effect on Windows in `Office2PDFSettingData`
- [Linux] Fix blank PDF output on Red Hat systems missing Calibri font
- Fix incorrect character spacing causing line break differences from original Word document
- Fix bold text appearing excessively thick in converted PDF output
- Fix missing last sentence in converted PDF for specific documents
- Fix graphical shape rendering deviations and incorrect text line breaks

---

# Foxit Conversion SDK v3.0.0

Release Date: 31 July 2025

## Breaking Changes

- Linux GCC minimum supported version changed from 4.9.4 to 5.4
- Node.js library drops support for Node.js v8 and v9

## New Features and Enhancements

### PDF to Office

- Add Go language support for Linux 32/64-bit platforms
- Add Python ABI3 compatibility for broader Python version support
- Improve text paragraph recognition to reduce text box output
- Improve conversion stability and output standardization
- Improve border table recognition
- Improve nested table output appearance in PDF-to-Word conversion
- Improve header/footer recognition in PDF-to-Word conversion
- Improve heading recognition in PDF-to-Word conversion
- Improve table output quality in PDF-to-Excel conversion

### Office to PDF

- Add Linux platform support for Office-to-PDF conversion
- Improve font loading performance for faster conversion
- Add multi-level nesting support for Drawing and Paragraph elements in Word-to-PDF conversion
- Add vertical paragraph alignment in Drawing objects for Word-to-PDF conversion
- Add PowerPoint page-level navigation support in PPT-to-PDF conversion

## Bug Fixes

### PDF to Word

- Fix converted Word document content being non-editable
- Fix crash during PDF-to-Word conversion stress testing with GSDK 10.0 Java Linux version
- Fix PDF-to-Word conversion getting stuck without producing output

### PDF to PowerPoint

- Fix extra gray background block in PDF-to-PPT conversion output

### Word to PDF

- Fix incorrect conversion of complex Word layouts with nested Drawing and Paragraph elements
- Fix Drawing objects with vertical paragraph alignment not rendering correctly
- Fix multi-layer Drawing objects displaying incorrectly
- Fix PowerPoint page-level navigation not being supported

---

# Foxit Conversion SDK v2.1.0

Release Date: 16 December 2024

## New Features and Enhancements

### PDF to Office

- Add page break insertion option via `PDF2WordSettingData` `enable_generate_page_rendered_break` parameter
- Add trailing space removal and image inclusion options via `PDF2OfficeSettingData`
- Add Excel workbook settings via `PDF2ExcelSettingData`
- Add restricted PDF file conversion support
- Add `ConvertCheckCallback` class and `SetConvertCheckCallback()` for conversion validation
- Update `PDF2Office::Initialize()` to accept `fx_binary_program_path` for improved conversion flexibility
- Improve table, formula, and highlighted text recognition in PDF-to-Word conversion
- Improve cell border and background recognition in PDF-to-Excel conversion
- Improve content integrity for converted text and paths in PDF-to-PPT conversion
- Improve processing efficiency for files with complex path structures
- Improve overall program stability to prevent memory leaks

### Office to PDF

- Add outline conversion support in Word-to-PDF via `Word2PDFConfig`
- Add workbook conversion options in Excel-to-PDF via `Excel2PDFConfig`
- Improve support for complex layouts including vertical text
- Improve preservation of gradients, multi-column alignment, and 3D elements
- Improve large file conversion stability and efficiency through memory optimization

---

# Foxit Conversion SDK v2.0.0

Release Date: 18 March 2024

## New Features and Enhancements

### Office to PDF

- Add Office-to-PDF conversion support for Windows (Word, Excel, PowerPoint) — beta

### PDF to Office

- Add footnote and endnote generation in PDF-to-Word conversion via `enable_generate_footnotes_and_endnotes` parameter
- Add header and footer generation in PDF-to-Word conversion via `enable_generate_headers_and_footers` parameter
- Add `PDF2ExcelSettingData` class for decimal symbol and thousands separator configuration
- Improve text block recognition accuracy in PDF-to-PowerPoint conversion

### Platform

- Add AnyCPU configuration support for Dotnet/DotNetCore

## Bug Fixes

- Fix conversion failure or slowdown due to high memory usage
- Fix crash when converting specific pages containing borderless tables in PDF-to-PPT conversion
- Fix text conversion anomalies including inconsistent fonts, text rendered as images, missing text, position offset, and overlap
- Fix incorrect underline recognition and extra spaces/line breaks in PDF-to-Word output
- Fix text content misidentified as tables in PDF-to-PPT conversion
- Fix multiple lines of text placed in same cell in PDF-to-Excel conversion
- Fix inconsistent page numbers and pages split into multiple pages in PDF-to-Word output

---

# Foxit Conversion SDK v1.5.0

Release Date: 07 November 2023

## New Features and Enhancements

### PDF to Office

- Add page range, PDF comment inclusion, and page layout retention settings via `PDF2OfficeSettingData`
- Improve KaiTi font support
- Improve chart recognition and output display
- Improve WPS Office compatibility for consistent formatting and font colors

## Bug Fixes

### PDF to Word

- Fix incorrect text styling including missing bold formatting and inconsistent font sizes
- Fix text overlap after conversion
- Fix page-level outline recognition and output issues
- Fix list recognition failures for specific files
- Fix highlight style and annotation display issues
- Fix inconsistent watermark layout between Word and PDF after conversion
- Fix missing title and author information in document properties
- Fix increased page count in output for specific files
- Fix text objects incorrectly recognized as shape objects for dual-layout content
- Fix extra empty paragraphs generated in output

### PDF to Excel

- Fix extended processing time and freezing for specific files
- Fix incomplete number display in cells after conversion
- Fix reduced text size within cells after conversion
- Fix shifted content within cells after conversion
- Fix cell content wrapping after conversion
- Fix missing cell backgrounds after conversion

---

# Foxit Conversion SDK v1.4.0

Release Date: 22 August 2023

## New Features and Enhancements

### PDF to Office

- Add heading conversion support from PDF to Word

### Platform

- Add Linux C library support
- Update Node.js compatibility to the latest version

## Bug Fixes

- Update OpenSSL to version 1.1.1 to address known vulnerability
- Fix numeric bullet point changes in PDF-to-Word output
- Fix bullet point misalignment in PDF-to-Word output
- Fix inconsistent content display in PDF-to-Excel output when opened in WPS Office
- Fix inconsistent display of converted files across different office editors
- Fix missing fonts and inconsistent font appearance in PDF-to-Word conversion for specific files
- Fix Calibri font changing to another font in PDF-to-Word output
- Fix table column width reduction causing data misalignment in PDF-to-Excel output
- Fix solid color cell backgrounds not properly recognized in PDF-to-Excel conversion
- Fix text becoming invisible after zooming in on PDF-to-Excel output in specific office editors

---

# Foxit Conversion SDK v1.3.0

Release Date: 09 June 2023

## New Features and Enhancements

### PDF to Office

- Add clip-path text recognition and conversion
- Add PDF pop-up comment and reply conversion to Word review comments in PDF-to-Word

### Platform

- Add Linux platform support
- Add multi-threading and thread safety

## Bug Fixes

- Fix missing spaces in converted output for specific files
- Fix incorrect recognition and conversion of underlined text
- Fix text being converted into images in specific files
- Fix crash and memory leak issues in Office conversions
- Fix misaligned paragraph formatting after converting text with highlighted StyleSpan

---

# Foxit Conversion SDK v1.2.0

Release Date: 04 April 2023

## New Features and Enhancements

### Platform

- Add Node.js conversion library hosted on GitHub
- Add Visual Studio 2019 and 2022 demo projects

---

# Foxit Conversion SDK v1.1.0

Release Date: 03 March 2023

## New Features and Enhancements

### PDF to Office

- Add AI-powered borderless table recognition via machine learning HTTP Restful API (`enable_ml_recognition` option)

---

# Foxit Conversion SDK v1.0.0

Release Date: 17 January 2023

## New Features and Enhancements

- Initial release supporting PDF-to-Word, PDF-to-Excel, and PDF-to-PowerPoint conversion on Windows
- Supported languages: C/C++, C# (DotNet, DotNetCore), Java, Node.js, Python
