Along with Markdown input, DITA-OT now provides three new transformation types to convert DITA content to Markdown, including the original syntax, GitHub-Flavored Markdown, and GitBook.

The new output formats can be used to feed DITA content into Markdown-based publishing systems or other workflows that lack the ability to process DITA XML.

Generating Markdown output

Markdown output can be generated by passing one of the following transformation types to the dita command with the --format option:

  • To publish Markdown DITA files, use the markdown transtype.

  • To generate GitHub Flavored Markdown files, use the markdown_github transtype.

  • To publish GitHub Flavored Markdown and generate a table of contents file for publication via GitBook, use the markdown_gitbook transtype.

Run the dita command and set the value of the output --format option to the desired format:

dita-ot-dir/bin/dita --input=input-file --format=markdown


  • dita-ot-dir is the DITA-OT installation directory.
  • input-file is the DITA map or DITA file that you want to process.