bn
/
se


			
				
					
						
						
							12345678910111213141516171819202122232425262728293031323334353637
							<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<!--  This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license.  -->

<topic id="markdown">
  <title>Markdown</title>
  <shortdesc>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.</shortdesc>

  <body>
    <p>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.</p>
    <section id="generating-markdown-output">
      <title>Generating Markdown output</title>
      <p>Markdown output can be generated by passing one of the following transformation types to the dita command with
        the <parmname>--format</parmname> option:</p>
      <ul>
        <li>
          <p>To publish Markdown DITA files, use the <option>markdown</option> transtype.</p></li>
        <li>
          <p>To generate
            <xref keyref="gfm-spec"/> files, use the <option>markdown_github</option> transtype.</p></li>
        <li>
          <p>To publish GitHub-Flavored Markdown and generate a <filepath>SUMMARY.md</filepath> table of contents file
            for publication via
            <xref format="html" href="https://www.gitbook.com" scope="external">GitBook</xref>, use the
              <option>markdown_gitbook</option> transtype.</p></li>
      </ul>
      <p>Run the <cmdname>dita</cmdname> command and set the value of the output <parmname>--format</parmname> option to
        the desired format:</p><codeblock xml:space="preserve"><filepath conref="../resources/conref-task.dita#ID/dita-cmd"/> <parmname>--input</parmname>=<varname>input-file</varname> <parmname>--format</parmname>=<option>markdown</option></codeblock>
      <p>where:</p>
      <ul>
        <li conref="../resources/conref-task.dita#ID/novice-variables-1"
          conrefend="../resources/conref-task.dita#ID/novice-variables-2"/>
      </ul></section>
  </body>
</topic>