Edit online

Dynamic Word/Excel/HTML/Markdown to DITA Converter

Restriction: This feature works with no restrictions if the publishing process is done using Oxygen XML Editor/Author. However, if the publishing process is done from a command line, this feature requires an Oxygen Publishing Engine license.

The publishing engine has support to dynamically convert various types of non-DITA resources to DITA while publishing. To enable this support for a particular resource that is referenced in a DITA map, you must specify one of the following values for the @format attribute on the <topicref> element:

Word to DITA (word-to-dita)

Microsoft Word documents that are referenced in the DITA map using the word-to-dita value for the @format attribute get dynamically converted to DITA topics during publishing. Image references and internal links are preserved.

Example:

<topicref href="sample.docx" format="word-to-dita"/>

Excel to DITA (excel-to-dita)

Microsoft Excel documents that are referenced in the DITA map using the excel-to-dita format attribute get dynamically converted to DITA topics that contain one or more tables during publishing.

Example:

<topicref href="sample.xlsx" format="excel-to-dita"/>

HTML to DITA (html-to-dita)

HTML documents that are referenced in the DITA map using the html-to-dita format attribute get dynamically converted to DITA topics during publishing.

Example:

<topicref href="sample.html" format="html-to-dita"/>

Markdown to DITA (markdown)

Markdown documents that are referenced in the DITA map using the markdown format attribute get dynamically converted to DITA topics during publishing using the support for Markdown bundled with the publishing engine by default.

Example:

<topicref href="sample.md" format="markdown"/>

Markdown to DITA (markdown-to-dita)

Markdown documents that are referenced in the DITA map using the markdown-to-dita format attribute get dynamically converted to DITA topics during publishing using the special conversion plugin provided by Oxygen XML Editor. The markdown-to-dita format conversion is more flexible that the built-in markdown conversion, allowing the conversion of Markdown documents that do not have consistent heading levels.

Example:

<topicref href="sample.md" format="markdown-to-dita"/>