Contribute to this guideReport an issue

guidePasting Content from Microsoft Word

This feature is provided through the Paste from Word plugin that is included in the Standard and Full presets available from the official CKEditor 4 Download site. You can also add it to your custom build with online builder.

The Paste from Word plugin allows you to paste content from Microsoft Word and maintain original content structure and formatting.

When enabled, it automatically detects Word content and transforms its structure and formatting to clean HTML. It also adds the Paste from Word toolbar button (Paste from Word toolbar button) which makes it possible to paste clipboard data this way only on demand.

# Supported Features

Paste from Word retains the following formatting:

  • Text formatting
    • Text and background colors
    • Font name, style and size
    • Basic formatting (bold, italic, underline)
    • Font effects (strikethrough, superscript, subscript)
    • Heading levels
    • Text alignment
  • Lists
    • Numbered and bulleted lists
    • Multilevel lists
    • Different numbering formats (Roman, decimal, alphanumeric)
    • Custom start number (e.g. you can start the list from number 4)
  • Tables
    • Borders and shading
    • Cell size (width and height)
    • Cell alignment
  • Images
  • Paste from Excel
    • Cell formatting (size, background, borders, special characters)
    • Row and column size
    • Text formatting (as listed above)
  • Advanced formatting
    • Default styles
    • User-defined styles

The Paste from Word plugin maintains most of Microsoft Word text formatting features with some exceptions related to advanced styling, customizations, or stylings that are not supported by HTML. For example, it will paste only standard bullets from the bullet library, or will not use a double strikethrough effect. Such elements are replaced by the default ones to resemble your Word content in the most accurate way.

# Advanced Paste from Word — CKEditor 4.6+

Pasting from Word is, in general, as tricky as it can get. With plenty of possible combinations of Microsoft Word, operating system and browser versions Word output that comes through clipboard to CKEditor 4 can significantly differ. This makes it extremely hard to support some of the more complicated content formatting cases that include text, images, lists, tables, nested objects, plenty of colors, styles and so on.

CKEditor 4 has always been a market leader in parsing Word content and transforming it to valid HTML, but handling some of the more complex cases and working around vendor bugs takes a lot of time, effort and experience. With some new tools available, such as Advanced Content Filter or Clipboard API, we have decided to rewrite the Paste from Word feature from scratch.

Here are some areas where the new, Advanced Paste from Word really shines:

  • Preservation of list numbering, styling and indentation (for example, nested lists with multiple levels, with different styling or custom list markers).
  • Document structure parsing that fixes plenty of issues with distorted or missing content after paste.
  • Smarter inline formatting, including preserving text or background color.
  • Handling hotlinked images.
  • Tight integration with Advanced Content Filter to efficiently adjust formatting coming from Word to what is allowed in a particular editor configuration.
  • Clean and valid HTML markup.

Note: Some Paste from Word configuration options were either dropped in CKEditor 4.6 or changed their default values. Please refer to the release notes for more details.

# Sample

The following sample content from a Microsoft Word document:

A sample Microsoft Word document.

will look like below after pasting to CKEditor 4 with the Paste from Word plugin enabled:

Microsoft Word content pasted into CKEditor 4 WYSIWYG editor.

Here is another sample with some more complicated formatting and styling as well as an image:

A sample Microsoft Word document with complex formatting and image.

It will look like this after pasting into CKEditor 4:

Complex Word content pasted into CKEditor 4 WYSIWYG editor.

In the example above you can see that after pasting into CKEditor 4, the first list has different list item markers than in the Word document. Although pasting lists with different markers is supported in CKEditor 4 (check the second and third list in the example above), this is a specific case. Such list style is not natively supported by the browser. However, it can be adjusted by using extra CSS rules (see a related StackOverflow thread how to style it properly).

# Filters

HTML exposed by Microsoft Word does not comply to any imaginable rules. It is a poetry of what can be done wrong. Therefore, a separate filter had to be created to normalize this content. It is implemented in the Paste from Word plugin and, beside the standard filtering options, it has additional settings:

Starting from version 4.6 of CKEditor the following options were deprecated:

For CKEditor versions older than 4.6 the following options were available, too:

# Paste from Word Demo

See the working “Pasting content from Microsoft Word” sample that showcases the Paste from Word plugin.

Refer to the following resources for more information about pasting content: