How to convert multiple Markdown files?

lkollar
Posts: 3

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?
Radu
Posts: 5620

Re: How to convert multiple Markdown files?

Wed Aug 09, 2017 3:38 pm

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 Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Radu
Posts: 5620

Re: How to convert multiple Markdown files?

Mon Mar 19, 2018 3:10 pm

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

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

Who is online

Users browsing this forum: No registered users and 0 guests