DOCX to DITA Conversion Overview

Use the Convert to DITA option to turn your DOCX files into valid and well-formed DITA files.

Tip: You can pre-format your Microsoft® Word documentation before converting it to DITA to exercise control over the conversion process.

Conversion Matrix Types

Table 1. Structural Elements Conversion Matrix
Important: The ignored structural elements are not included in the converted DITA files. For example, the DOCX subtitles are not visible in the DITA files after conversion.
DOCXDITA
Document TitleMap title element
Heading 1New DITA topic of type topic with the title element corresponding to the Heading name
Headings 2, 3, etc.New DITA topic of type topic, contained by the topic converted from the preceding Heading 1
Paragraphparagraph element
Document SubtitleIgnored
Page BreakIgnored
Table 2. Formatted Text Conversion Matrix
Important: The ignored text formatting is not visible in the converted DITA files. For example, highlighted text in a DOCX file is converted to DITA as regular text.
DOCXDITA
Boldbold element
Bulleted Listunordered list element
Footnotefootnote element
Imageimage element
Italicsitalics element
Ordered Listordered list element
Subscriptsubscript element
Superscriptsuperscript element
SymbolsPlain text symbols
Tabletable element
Underlineunderline element
HighlightIgnored
StrikethroughIgnored
Text AlignmentIgnored
Text ColoringIgnored
Table 3. Metadata Conversion Matrix
DOCXDITA
DOCX metadataDITA metadata

DOCX to DITA Conversion Example

The following example illustrates how a DOCX file converts to DITA.

Table 4. Resources Converted from a Sample DOCX Document
ResourcesDescription
DITA mapThe DITA map file name corresponds to the DOCX file name. The converted DITA topics are automatically appended to the DITA map.
DITA topicsThe DITA topics file names correspond to their IDs. The IDs are assigned automatically during the conversion.
Files folderThe media files included in the DOCX file are gathered in this folder.
Note: If the DITA structure looks accurate, DITA maps converted from DOCX documents can be published right after the conversion completes.