Import and Export to Word On-Premises
# 1.15.0 (2023-09-19)
# Import from Word
# Features
-
Added CSS resets and extended formatting support
Browsers provide their own CSS stylesheets that apply default formatting to common HTML elements. Unfortunately, this formatting is incompatible with the default Word formatting. Previously, the IFW converter did not support overwriting conflicting browser styles. Now a new configuration option
formatting.resets
is available. It can be used to change selected formatting properties to the same values that are used in Word by default.Along with this change, we introduced the new
formatting
configuration option that can be used to control the outputted formatting in a more granular way:type ConversionConfig = { formatting?: { resets?: 'none' | 'inline'; defaults?: 'none' | 'inline'; styles?: 'none' | 'inline'; comments?: 'none' | 'basic' | 'full'; }; };
The old
default_styles
andcollaboration_features.comments_styles
options are now deprecated in favor offormatting.defaults
andformatting.comments
respectively. -
Added default table styles
Tables in Word have some default formatting defined implicitly. For example, text in table cells is by default vertically aligned to the top, and tables themselves are aligned to the left. These properties differ from the default HTML formatting, where, for example, the content of table cells is by default centered. However, they are not saved anywhere in documents, so the converter added them as direct formatting to minimize the visual differences between Word and the HTML output. Unfortunately, this means that such default styles were always outputted regardless of whether the conversion of default formatting was actually enabled.
In this release, the implicit table formatting starts being recognized as the default formatting and is no longer added to the output if the
formatting.defaults
option is set tofalse
. Along with this change, we also extended support for default table formatting, and table borders are now collapsed by default.Please note that this may change the content produced by the converter when documents are converted with the conversion of default formatting disabled (which is the default case).
# Bug fixes
-
Fixed support for simple fields
Previously, some fields such as
DATE
could be incorrectly converted, resulting in content loss. Now, the converter will properly preserve the content of such fields. -
Fixed escaping font names in CSS
When some part of a document was using a font with specific characters in its name, the converter outputted invalid CSS due to a lack of proper character escaping. This means that browsers ignored the outputted formatting and such fonts were not properly applied in the output. The Import from Word converter now properly escapes these characters.
# Export to Word
# Bug fixes
-
Fixed support for images inside span elements within tables
-
Fixed the rendering of documents with over 20,000 paragraphs
-
Fixed a problem with preserving multiple successive spaces in exported documents
Added a proper whitespace handling mechanism that preserves whitespace characters consistent with browser vendors.
-
Fixed incorrect handling of suggestions in lists when a suggestion was nested inside inline element with no other content
The documents containing suggestions inside inline elements should no longer be broken.
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.14.1 (2023-07-25)
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.14.0 (2023-07-11)
# Import from Word
# Features
-
Added support for the Strict Open XML format
The
.docx
files can be saved in the Strict Open XML mode, which differs significantly from the regular mode. This release adds support for DOCX files saved in the strict mode, resulting in better coverage of supported document formats.
# Bug fixes
-
Advanced Table Formatting: Last column formatting is not applied to merged table cells
Formatting of the last table column was ignored when the last table cell in a table row spanned multiple columns. Thanks to the fix, cells in the last column always have conditional formatting properly applied now.
-
Advanced Table Formatting: Formatting of corner cells in the last column is not applied to merged table cells
Formatting of corner cells in the last column was not applied when those cells spanned multiple columns. The fix should now ensure proper resolution of formatting for corner cells in the last column.
-
Advanced Table Formatting: Similar formatting regions should be mutually exclusive
When table cells belong to similar table regions, only formatting from one such region should be applied. For example, consider a table that contains a single cell. This cell belongs to both the first and the last column. However, in Word, only the formatting of the first column is applied to that cell. Import from Word follows the same behavior as Word now.
-
Table of Contents: Line breaks in headings are not properly supported
Headings in Word may contain soft line breaks, which are typically replaced by a single space character by default. However, the converter ignored those line breaks, resulting in a lack of whitespace in the output.
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.13.0 (2023-05-30)
# Export to Word
# Features
-
Added support for resolved comments
Comments that are marked as
comment.is_resolved
will be resolved in a Word document.
# Bug fixes
-
Fixed generating Word documents with list suggestions
Suggestions in list items sometimes caused producing broken Word documents
-
Fixed broken conversion due to loading CSS
Some CSS syntax caused conversion to fail. The fix skips the invalid CSS properties.
# Import from Word
# Features
-
Added support for advanced table formatting
In Word, table styles can define the formatting of particular table sections, for example, the background color of cells in the last table row. In fact, many table styles built-in into Word use such formatting. Now, the Import from Word converter recognizes and properly converts it.
-
Added support for archived comments
Recently, CKEditor 5 released a feature called “comments archive” that allows archiving comments that are no longer necessary. Word, on the other hand, has an option that marks comments and entire comment threads as resolved. Until now, the Import from Word converter did not return any information on whether a comment is resolved or not, but since this release converted comments contain a new property called is_resolved that can be used to archive imported comments in CKEditor.
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.12.0 (2023-04-28)
# Import from Word
# Features
-
Added support for table of contents
This release brings support for the table of contents. Currently, two possible formats of the table of contents are supported:
- Automatic table of contents
- Custom table of contents
-
Added support for horizontal alignment of non-inline images
In Word, there are two types of images: inline and floating. The latter can be freely positioned and have its other settings, such as text wrapping, modified. In this release, support for the horizontal alignment of floating images was added.
Note that HTML does not support a centered image with text wrapped around it, and thus importing such images does not preserve text wrapping.
-
Added support for 3D rotation via camera presets
Extending support for image rotation from the previous release: support for camera presets was added. Camera presets available from the 3-D Rotation tab of the Format Picture menu and containing rotation settings are converted properly now.
# Bug fixes
-
Fixed incorrectly aligned images
Disabling the
config.default_styles
option sometimes caused imported images to be misaligned. This release patched this issue and now images should have proper alignment regardless of thedefault_styles
option.
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.11.0 (2023-04-04)
# Export to Word
# Features
-
Added support for text indentation
The
text-indent
CSS property on paragraphs is properly recognized and applied to the Word document. Text indentation support is limited to absolute units, like pixels.
# Bug fixes
-
Fixed an issue where an invalid HTML table structure resulted in producing broken Word documents
Tables that are missing some part of the proper table structure, for example, empty table rows, are now properly handled by the converter.
-
Fixed an issue where block elements inside list items were producing invalid HTML
Block elements inside list items are converted to inline ones to preserve the correct list structure. Tables are extracted from lists as they are not supported in lists by Word.
-
Fixed an issue with fetching images from external servers
png
andjpg
images are now always downloaded and included in the `.docx`` file.
# Import from Word
# Features
-
Added support for conversion of SVGs
The Import from Word converter can correctly convert images using the SVG format. It supports both embedded and linked images.
-
Added advanced underline styling
Previously, the converter always outputted underline as a solid black line. Now, it supports underlines that use different colors or shapes. However, not all shapes available in Word are supported by CSS, hence some are transformed into the closest matching equivalents.
Advanced underline styling is represented using various
text-decoration-*
CSS properties. Additionally, please note that CKEditor 5 may need extra General HTML Support (GHS) plugin configuration to preserve it. -
Added support for image rotation
Image rotation is now preserved by the converter. Both 2D and 3D rotations are supported. Currently, the default camera preset is supported.
Rotation is outputted as a transform CSS property, and thus it behaves slightly differently from Word: rotated images may overlap text in preceding and following paragraphs. This feature also needs an additional GHS configuration in order to work in CKEditor 5.
-
Added bookmarks support
Bookmarks are document regions associated with some name. They can be used, for example, to create links to fragments of a document. They are now supported by the Import from Word converter that represents them using an empty
<a>
element with the bookmark name saved in id and name attributes. Links to bookmarks are represented by URI fragments.Note that, presently, CKEditor 5 does not support bookmarks.
-
Added support for custom unordered list bullets
Many Word documents contain custom bullets in unordered lists. The converter is used to transform them into the default circle bullet. Now, it preserves them in most common cases. However, non-standard symbol typefaces may sometimes produce unexpected results for now.
# Bug fixes
-
Trailing whitespace characters no longer preserve the background color
Some whitespace characters (such as the regular space or the em space) do not have their background color rendered by Word when they are at the end of a text line. The converter now detects such characters when they are located either at the end of a paragraph or before a soft line break and strips background styling from them. Note that the converter cannot detect trailing whitespace characters at the end of arbitrary text lines as of now.
-
Emoji sequences with attached comments are no longer broken into parts
Previously, the converter split emoji sequences into individual parts when a comment was attached to them. For example, the 👩👩👦👦 emoji sequence with a comment attached to it would be split into 👩👩👦👦. It is correctly preserved now.
-
Fixed invalid conversion of list definitions using none numbering format
List items that use the none numbering format and that do not have any additional numbering text are no longer outputted with the default circle bullet, but rather have no marker at all.
-
Fixed parsing of external images
Images that were not embedded into a document itself used to cause conversion errors. Now, the converter correctly supports them.
-
Fixed comments conversion in empty tables
Until now, comments attached to empty tables were not preserved. This is no longer the case. However, note that there’s still an open issue regarding comments in empty tables in CKEditor 5.
-
Preserved level definitions in multi-level lists
Skipped list levels are no longer represented by lists with invisible markers, but rather by particular list items with invisible markers. This improves the editing experience of such lists in CKEditor because items inserted at previously skipped levels have their marker formats preserved now.
-
Improved handling of spaces
The Import from Word converter follows the space behavior in HTML more strictly now. It also no longer eagerly transforms regular spaces into non-breaking ones. This improves line-wrapping behavior because in some cases, the styled text could cause unnecessary line wraps.
-
Improved HTML output for collaboration features
The HTML produced for collaboration features has been optimized to reduce unnecessary styling duplications over content that has the same visual effect.
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.10.0 (2023-02-07)
# Export to Word
# Features
-
Added better support for complex suggestions nesting
Significantly improved support for nested suggestions of both the insertion and deletion types.
# Bug fixes
-
Fixed nested suggestions generating a broken document
Nested suggestions of insertion and deletion types sometimes resulted in producing broken documents. After the fix, complex suggestions nesting is more stable.
-
Fixed various conversion issues caused by nesting content inside div elements
In some cases, nesting content inside div elements resulted in producing broken documents or applying incorrect style over nested inline content. After the changes, content nested in div elements is properly recognized.
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.9.0 (2022-11-29)
# Export to Word
# Features
-
Added the
base_url
conversion optionThis option allows setting the base URL for resolving images’ and links’ relative URLs in the content, e.g. setting the
base_url
option tohttps://ckeditor.com
will result in resolving the/docs
link as thehttps://ckeditor.com/docs
one. -
Added support for SVG images
SVG images are now supported by the converter, both as base64 and URL links.
# Bug fixes
-
Fixed the issue where conversion of the style element inside other elements breaks conversion.
After the fix, the style element can be placed inside other elements, e.g. a div and the CSS styles will be properly preserved.
# Import from Word
# Features
-
Added the
config.collaboration_features.comments_styles
configuration optionIt allows to choose one of the existing presets (none, basic, full), allowing to configure which comments’ styles should be converted.
# Bug fixes
-
Fixed the issue where in rare cases imported tables had incorrect width
-
Fixed the issue where in rare cases text background turned black
-
Fixed incorrect parsing of suggestions that is applied to a link spanning over multiple blocks
-
Fixed emoji groups being split during the conversion
# Other changes
-
Reduced HTML payload size and improved its quality
It was done by merging side CSS properties to CSS property shorthands.
As an example, properties such asborder-top
,border-right
,border-bottom
, andborder-left
will be reduced to a singleborder
property.
# Common changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.8.1 (2022-11-08)
# Bug fixes
-
Fixed incorrect log messages while using an unlimited license
While using an unlimited license, notifications with information about overusage were present in the application logs.
Now the logs are present only after exceeding the limits in case of a limited license.
# 1.8.0 (2022-11-02)
# Features
-
Added support for Import from Word
Import from Word allows to convert a Word file into HTML code. Comments and suggestions will also be extracted.
You will find more information about the feature in our on-line documentation.
The feature requires a separate license. To start using it, please contact our sales or subscribe to our free 30-day trial.
# Other changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.7.4 (2022-10-18)
# Other changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.7.3 (2022-09-06)
# Bug fixes
-
Fixed incorrect handling of page breaks inside table cells
Page breaks inside table cells were breaking document conversion. After the fix, page breaks are properly recognized in the produced Word documents.
-
Fixed conversion fails if figcaption was placed under a figure with a class attribute that lacks image or table class name
When figcaption was placed under a figure with a class attribute that lacks an image class name, the conversion failed. After the fix, the conversion is successful and the figcaption is placed in the Word document.
-
Fixed conversion fails if a figcaption was placed inside a table figure element
After the fix, table figcaption elements are ignored, no longer causing the conversion to fail.
# Other changes
-
Improved error messages
Messages returned by document conversion provide better debugging experience to integrators if the conversion failed.
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.7.2 (2022-07-26)
# Other changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.7.1 (2022-06-14)
# Other changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.7.0 (2022-05-05)
# Features
-
Added support for specifying width of table cells and columns
The width of table cells can be specified by the width style and the
colgroup
element. -
Added support for ARM64v8 CPU architecture
The Export to Word On-Premises Server can now be run on machines with the ARM64v8 CPU architecture.
# Other changes
-
Updated dependencies
Selected dependencies have been updated to the latest versions, improving performance and security.
# 1.6.0 (2022-03-22)
# Features
-
Introduced auto paragraphing for orphan nodes
Orphan text or inline nodes are automatically wrapped with paragraphs.
-
Added support for comments inside table cells
Table cells show commented cell content if added.
-
Added support for suggestions inside table cells
Table cells show cell content suggestions if added.
-
Improved features compatibility for older (<365) MS Word versions
Documents with images in base64 format and tables are now correctly supported when opening documents with older MS Word versions (<365).
# Bug fixes
-
Fixed empty href in links breaking conversion
-
Fixed broken documents caused by invalid markup for comments
-
Fixed an issue where code snippets in table cells have an additional paragraph under a snippet
-
Fixed an issue where blockquote elements including plain text content broke document conversion
# Other changes
-
Updated dependencies
Updated selected dependencies to the latest versions - improved the performance and security.
-
Cleaned up dependencies
-
Improved error messages
Some of the errors now contain more detailed messages, including explanations and possible actions to solve the problem.
# 1.5.2 (2022-02-08)
# Other changes
-
Updated dependencies
Updated selected dependencies to the latest versions - improved the performance and security.
# 1.5.1 (2022-01-18)
# Other changes
-
Update Node.js to version 16
-
Updated dependencies
Updated selected dependencies to the latest versions - improved the performance and security.
# 1.5.0 (2021-11-16)
# Features
-
Added support for autoparagraphing plain text comments
Comment content property was only accepting HTML content. From now on, it is possible to use plain text also, which helps with custom CKEditor 5 comments integration.
# Bug fixes
- Fixed incorrect generation of suggestions for new paragraphs
# Other changes
-
Updated dependencies
Updated selected dependencies to the latest versions - improved the performance and security.
From this version on, the Docker Engine 20.10 or higher is recommended. -
Updated base docker image (Alpine Linux) from version 3.12 to 3.14
-
Added an orientation parameter to the demo page
# 1.4.0 (2021-10-05)
# Features
-
Added support for custom numbering in lists
List styles supported in CKEditor 5 are also supported by the converter.
-
Enabled starting ordered lists from number other than 1
Starting an order list from number other than 1 can be accomplished by providing a [start] attribute.
-
Added support for list indentation
You can control the indentation of list elements by providing margin style.
-
Added support for table and table figure width
You can control the width of table elements by providing width attribute or style.
-
Added support for page orientation
Page orientation can be set using the
options.orientation
property, accepting portrait (default) and landscape values.
# Bug fixes
-
Fixed documents broken due to inserting empty table cells or table cells with multiple spaces
-
Fixed conversion of images that are not inside a paragraph or a figure element
-
Fixed issue with suggestions spanning two paragraphs instead of ending on the first one
-
Fixed incorrect generation of suggestions for new paragraphs
# Other changes
-
Updated dependencies
Updated selected dependencies to the latest versions - improved the performance and security.
# 1.3.0 (2021-08-24)
# Features
-
Increased maximum size of the HTML
The service allows to convert HTML with the maximum size of the content 20 MB.
# Other changes
-
Improved logs readability
-
Updated dependencies
Updated selected dependencies to the latest versions - improved the performance and security.
# 1.2.1 (2021-04-04)
# Features
-
Introduced support for inline images
Inline images (images that are inside a paragraph) are now correctly rendered.
-
Introduced support for nested tables
The converter now supports HTML with nested tables (tables inserted into other tables’ cells).
# Bug fixes
-
Fixed the header/footer CSS validation. CSS is now not obligatory
-
Fixed adjacent
hr
s rendering -
Fixed the generation of documents containing
div
elements withtable
elements inside -
Fixed the API section in the documentation
# Other changes
-
Cleaned up logs
Removed stack traces, fixed data serialization and improved messages.
# 1.1.0 (2021-02-25)
# Features
-
Added validation for document’s margins
Supported units:
in
,cm
,mm
,px
. -
Added support for auto pagination feature
The auto pagination feature is enabled by default now.
-
Added a creation date for comments
The
created
param is required for comments now. -
Added the timezone option for a document
Use the
timezone
option to set a document timezone. For example, if you use Comments and suggestions feature, created date time metadata will include the provided timezone option or UTC if the timezone option has not been set. -
Added support for tables alignment
Enabled support to align tables to left and right using CSS
float
property. -
Added support for comments in suggestion threads
Comments inside suggestion threads are preserved as a separate comment thread on the same range as suggestion.
-
Added support for the page number and total pages in document headers and footers
Headers and footers support dynamic data like current page number and total page number. It can be inserted by using the special placeholder element in header/footer HTML. For current page number use and for total page number.
# Bug fixes
-
Fixed block quotes nested inside a table breaks a document
-
Fixed Horizontal line after or before a code block is rendered inside it
-
Fixed the styled text inside a link causes a link loss
# Other changes
-
Improved various document formatting to make it more similar to CKEditor 5 content
-
Improved demo page
The demo page is now more readable and allows to use all available converter’s features.
-
Updated documentation
# 1.0.0 (2020-08-25)
# Features
-
Added On-Premise version of DOCX Converter.
The service allows to convert HTML into DOCX documents via the REST API.
-
Added authorization.
JWT authorization can be set with
SECRET_KEY
environment variable.