Download Foxit PDF Conversion SDK 3.1 for Windows (.NET)

# 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 `Office2PDFSettingdаta::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