How to convert multiple Markdown files?

Posts: 1

How to convert multiple Markdown files?

Tue Aug 08, 2017 6:07 pm

We're experimenting with using Markdown as an intermediate step to move our documentation to DITA. It works well enough, except there doesn't seem to be a way to convert an entire ditamap and its linked files to DITA except for one at a time. Or have I missed it?
Posts: 5208

Re: How to convert multiple Markdown files?

Wed Aug 09, 2017 3:38 pm


Right now you can open a Markdown file in Oxygen, right click it and choose to export it as a DITA topic or as HTML. Probably in a future version we'll also add some support of doing batch conversions.

Until then you can try to google for a batch markdown to HTML converter, there is a versatile converter called "Pandoc" which can probably do that.

As you already seem to have the DITA Map which references the Markdown files, after you open the DITA Map in the DITA Maps Manager view open the "Configure Transformation Scenarios" dialog, click the "New" button -> "DITA OT Transformation" and choose the "normalize" transformation. This should generate in the output folder a DITA topic for each markdown file. The files will still have the ".md" extension but they will be DITA XML.

Radu Coravu
<oXygen/> XML Editor

Return to “DITA (Editing and Publishing DITA Content)”

Who is online

Users browsing this forum: No registered users and 0 guests