How to convert multiple Markdown files?

[lkollar]

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?

[Radu]

Hi,

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.

Regards,
Radu

[Radu]

Hi,

Just to update this thread, there is an Oxygen add-on which can be installed to convert multiple Markdown files to DITA:

https://github.com/oxygenxml/oxygen-resources-converter

Regards,
Radu