首頁 探索 說明
登入
bn
/
se
2
0
複刻 0
檔案 問題管理 0 合併請求 0 Wiki
目錄樹: a4b429aad5
分支列表 標籤列表
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.3.3
/
doc
/
topics
/
markdown-dita-syntax-reference.html

markdown-dita-syntax-reference.html 19 KB
文件歷史 原始文件

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330 
  1. <!DOCTYPE html
    2. 

  2.   SYSTEM "about:legacy-compat">
    3. 

  3. <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2019"><meta name="DC.rights.owner" content="(C) Copyright 2019"><meta name="DC.type" content="topic"><meta name="description" content="Markdown DITA uses CommonMark as the underlying markup language."><meta name="DC.subject" content="Pandoc, UTF, DITA, specializations, Markdown, CommonMark"><meta name="keywords" content="Pandoc, UTF, DITA, specializations, Markdown, CommonMark"><meta name="DC.relation" scheme="URI" content="../topics/alternative-input-formats.html"><meta name="DC.relation" scheme="URI" content="../topics/markdown-input.html"><meta name="DC.relation" scheme="URI" content="../topics/lwdita-input.html"><meta name="DC.format" content="HTML5"><meta name="DC.identifier" content="markdown-dita-syntax-reference"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Markdown DITA syntax reference</title></head><body id="markdown-dita-syntax-reference"><header role="banner"><div class="header">
    4. 

  4.   <p>DITA Open Toolkit</p>
    5. 

  5.   <hr>
    6. 

  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 3.3</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../topics/installing-client.html">Installing DITA-OT</a></li><li><a href="../topics/alternative-input-formats.html">Authoring formats</a><ul><li><a href="../topics/markdown-input.html">Markdown content</a></li><li><a href="../topics/lwdita-input.html">Lightweight DITA</a></li><li class="active"><a href="../topics/markdown-dita-syntax-reference.html">Markdown DITA syntax</a></li></ul></li><li><a href="../topics/building-output.html">Building output</a></li><li><a href="../parameters/index.html">Setting parameters</a></li><li><a href="../topics/customizing.html">Customizing DITA-OT</a></li><li><a href="../topics/troubleshooting-overview.html">Troubleshooting</a></li><li><a href="../reference/index.html">Reference</a></li><li><a href="../topics/dita-and-dita-ot-resources.html">Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7.   <h1 class="title topictitle1" id="ariaid-title1">Markdown DITA syntax reference</h1>
    8. 

  8.   
    9. 

  9.   
    10. 

  10.   
    11. 

  11. 

  12.   <div class="body"><p class="shortdesc">Markdown DITA uses
    13. 

  13.     <a class="xref" href="http://commonmark.org" target="_blank">CommonMark</a> as the underlying markup language.</p>
    14. 

  14.     <p class="p">Markdown DITA files must be UTF-8 encoded.</p>
    15. 

  15.     <section class="section" id="markdown-dita-syntax-reference__titles-and-document-structure"><h2 class="title sectiontitle">Titles and document structure</h2>
    16. 

  16.       
    17. 

  17.       <p class="p">Each header level will generate a topic and associated title:</p>
    18. 

  18.       <pre class="pre codeblock language-markdown"><code># Topic title
    19. 

  19. 

  20. ## Nested topic title</code></pre><pre class="pre codeblock language-xml"><code>&lt;topic id="topic_title"&gt;
    21. 

  21.   &lt;title&gt;Topic title&lt;/title&gt;
    22. 

  22.   &lt;topic id="nested_topic_title"&gt;
    23. 

  23.     &lt;title&gt;Nested topic title&lt;/title&gt;
    24. 

  24.   &lt;/topic&gt;
    25. 

  25. &lt;/topic&gt;</code></pre>
    26. 

  26.       <p class="p">Pandoc
    27. 

  27.         <a class="xref" href="http://pandoc.org/MANUAL.html#extension-header_attributes" target="_blank">header_attributes</a> can be used to define <code class="ph codeph">id</code> or
    28. 

  28.           <code class="ph codeph">outputclass</code> attributes:</p><pre class="pre codeblock language-markdown"><code># Topic title {#carrot .juice}</code></pre><pre class="pre codeblock language-xml"><code>&lt;topic id="carrot" outputclass="juice"&gt;
    29. 

  29.   &lt;title&gt;Topic title&lt;/title&gt;</code></pre>
    30. 

  30.       <p class="p">If topic ID is not defined using header_attributes, the ID is generated from title contents.</p>
    31. 

  31.       <p class="p">Pandoc
    32. 

  32.         <a class="xref" href="http://pandoc.org/MANUAL.html#extension-pandoc_title_block" target="_blank">pandoc_title_block</a>
    33. 

  33.         extension can be used to group multiple level 1 headers under a common
    34. 

  34.       title:</p><pre class="pre codeblock language-markdown"><code>% Common title
    35. 

  35. 

  36. # Topic title
    37. 

  37. 

  38. # Second title</code></pre><pre class="pre codeblock language-xml"><code>&lt;topic id="common_title"&gt;
    39. 

  39.   &lt;title&gt;Common title&lt;/title&gt;
    40. 

  40.   &lt;topic id="topic_title"&gt;
    41. 

  41.     &lt;title&gt;Topic title&lt;/title&gt;
    42. 

  42.   &lt;/topic&gt;
    43. 

  43.   &lt;topic id="second_title"&gt;
    44. 

  44.     &lt;title&gt;Second title&lt;/title&gt;
    45. 

  45.   &lt;/topic&gt;
    46. 

  46. &lt;/topic&gt;</code></pre></section>
    47. 

  47.     <section class="section" id="markdown-dita-syntax-reference__topic-content"><h2 class="title sectiontitle">Topic content</h2>
    48. 

  48.       
    49. 

  49.       <p class="p">In LwDITA compatible documents (MDITA) the first paragraph is treated as a <code class="ph codeph">shortdesc</code> element.
    50. 

  50.         In generic Markdown documents all paragraphs appear inside the <code class="ph codeph">body</code> element.</p></section>
    51. 

  51.     <section class="section" id="markdown-dita-syntax-reference__specialization-types"><h2 class="title sectiontitle">Specialization types</h2>
    52. 

  52.       
    53. 

  53.       <p class="p">The following class values in
    54. 

  54.         <a class="xref" href="http://pandoc.org/MANUAL.html#extension-header_attributes" target="_blank">header_attributes</a> have a special meaning on level 1 headers:</p>
    55. 

  55.       <ul class="ul">
    56. 

  56.         <li class="li">
    57. 

  57.           <p class="p"><code class="ph codeph">concept</code></p></li>
    58. 

  58.         <li class="li">
    59. 

  59.           <p class="p"><code class="ph codeph">task</code></p></li>
    60. 

  60.         <li class="li">
    61. 

  61.           <p class="p"><code class="ph codeph">reference</code></p></li>
    62. 

  62.       </ul>
    63. 

  63.       <p class="p">They can be used to change the Markdown DITA topic type to one of the built-in structural specialization
    64. 

  64.         types.</p><pre class="pre codeblock language-markdown"><code># Task {.task}
    65. 

  65. 

  66. Context
    67. 

  67. 

  68. 1.  Command
    69. 

  69. 

  70.     Info.</code></pre><pre class="pre codeblock language-xml"><code>&lt;task id="task"&gt;
    71. 

  71.   &lt;title&gt;Task &lt;/title&gt;
    72. 

  72.   &lt;taskbody&gt;
    73. 

  73.     &lt;context&gt;
    74. 

  74.       &lt;p&gt;Context&lt;/p&gt;
    75. 

  75.     &lt;/context&gt;
    76. 

  76.     &lt;steps&gt;
    77. 

  77.       &lt;step&gt;
    78. 

  78.         &lt;cmd&gt;Command&lt;/cmd&gt;
    79. 

  79.         &lt;info&gt;
    80. 

  80.           &lt;p&gt;Info.&lt;/p&gt;
    81. 

  81.         &lt;/info&gt;
    82. 

  82.       &lt;/step&gt;
    83. 

  83.     &lt;/steps&gt;
    84. 

  84.   &lt;/taskbody&gt;
    85. 

  85. &lt;/task&gt;</code></pre></section>
    86. 

  86.     <section class="section" id="markdown-dita-syntax-reference__sections"><h2 class="title sectiontitle">Sections</h2>
    87. 

  87.       
    88. 

  88.       <p class="p">The following class values in
    89. 

  89.         <a class="xref" href="http://pandoc.org/MANUAL.html#extension-header_attributes" target="_blank">header_attributes</a> have a special meaning on header levels other than 1:</p>
    90. 

  90.       <ul class="ul">
    91. 

  91.         <li class="li">
    92. 

  92.           <p class="p"><code class="ph codeph">section</code></p></li>
    93. 

  93.         <li class="li">
    94. 

  94.           <p class="p"><code class="ph codeph">example</code></p></li>
    95. 

  95.       </ul>
    96. 

  96.       <p class="p">They are used to generate
    97. 

  97.         <a class="xref" href="http://docs.oasis-open.org/dita/v1.2/os/spec/langref/section.html" target="_blank"><code class="ph codeph">section</code></a> and
    98. 

  98.         <a class="xref" href="http://docs.oasis-open.org/dita/v1.2/os/spec/langref/example.html" target="_blank"><code class="ph codeph">example</code></a>
    99. 

  99.       elements:</p><pre class="pre codeblock language-markdown"><code># Topic title
    100. 

  100. 

  101. ## Section title {.section}
    102. 

  102. 

  103. ## Example title {.example}</code></pre><pre class="pre codeblock language-xml"><code>&lt;topic id="topic_title"&gt;
    104. 

  104.   &lt;title&gt;Topic title&lt;/title&gt;
    105. 

  105.   &lt;body&gt;
    106. 

  106.     &lt;section&gt;
    107. 

  107.       &lt;title&gt;Section title&lt;/title&gt;
    108. 

  108.     &lt;/section&gt;
    109. 

  109.     &lt;example&gt;
    110. 

  110.       &lt;title&gt;Example title&lt;/title&gt;
    111. 

  111.     &lt;/example&gt;
    112. 

  112.   &lt;/body&gt;
    113. 

  113. &lt;/topic&gt;</code></pre></section>
    114. 

  114.     <section class="section" id="markdown-dita-syntax-reference__links"><h2 class="title sectiontitle">Links</h2>
    115. 

  115.       
    116. 

  116.       <p class="p">The format of local link targets is detected based on file extension. The following extensions are treated as
    117. 

  117.         DITA files:</p>
    118. 

  118.       <table class="table table-hover frame-none"><caption></caption><colgroup><col><col></colgroup><thead class="thead">
    119. 

  119.             <tr class="row">
    120. 

  120.               <th class="entry colsep-0 rowsep-1" id="markdown-dita-syntax-reference__links__entry__1">extension</th>
    121. 

  121.               <th class="entry colsep-0 rowsep-1" id="markdown-dita-syntax-reference__links__entry__2">format</th>
    122. 

  122.             </tr>
    123. 

  123.           </thead><tbody class="tbody">
    124. 

  124.             <tr class="row">
    125. 

  125.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__1"><code class="ph codeph">.dita</code></td>
    126. 

  126.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__2"><code class="ph codeph">dita</code></td>
    127. 

  127.             </tr>
    128. 

  128.             <tr class="row">
    129. 

  129.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__1"><code class="ph codeph">.xml</code></td>
    130. 

  130.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__2"><code class="ph codeph">dita</code></td>
    131. 

  131.             </tr>
    132. 

  132.             <tr class="row">
    133. 

  133.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__1"><code class="ph codeph">.md</code></td>
    134. 

  134.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__2"><code class="ph codeph">markdown</code></td>
    135. 

  135.             </tr>
    136. 

  136.             <tr class="row">
    137. 

  137.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__1"><code class="ph codeph">.markdown</code></td>
    138. 

  138.               <td class="entry colsep-0 rowsep-1" headers="markdown-dita-syntax-reference__links__entry__2"><code class="ph codeph">markdown</code></td>
    139. 

  139.             </tr>
    140. 

  140.           </tbody></table>
    141. 

  141.       <p class="p">All other link targets use <code class="ph codeph">format</code> from file extension and are treated as non-DITA files.
    142. 

  142.         Absolute links targets are treated as external scope
    143. 

  143.       links:</p><pre class="pre codeblock language-markdown"><code>[Markdown](test.md)
    144. 

  144. [DITA](test.dita)
    145. 

  145. [HTML](test.html)
    146. 

  146. [External](http://www.example.com/test.html)</code></pre><pre class="pre codeblock language-xml"><code>&lt;xref href="test.md"&gt;Markdown&lt;/xref&gt;
    147. 

  147. &lt;xref href="test.dita"&gt;DITA&lt;/xref&gt;
    148. 

  148. &lt;xref href="test.html" format="html"&gt;HTML&lt;/xref&gt;
    149. 

  149. &lt;xref href="http://www.example.com/test.html" format="html" scope="external"&gt;External&lt;/xref&gt;</code></pre></section>
    150. 

  150.     <section class="section" id="markdown-dita-syntax-reference__images"><h2 class="title sectiontitle">Images</h2>
    151. 

  151.       
    152. 

  152.       <div class="div div-index">
    153. 

  153.         
    154. 

  154.       </div>
    155. 

  155.       <p class="p">Images used in inline content will result in inline placement. If a block level image contains a title, it will
    156. 

  156.         be treated as an image wrapped in
    157. 

  157.       figure:</p><pre class="pre codeblock language-markdown"><code>An inline ![Alt](test.jpg).
    158. 

  158. 

  159. ![Alt](test.jpg)
    160. 

  160. 

  161. ![Alt](test.jpg "Title")</code></pre><pre class="pre codeblock language-xml"><code>&lt;p&gt;An inline &lt;image href="test.jpg"&gt;&lt;alt&gt;Alt&lt;/alt&gt;&lt;/image&gt;.&lt;/p&gt;
    162. 

  162. &lt;image href="test.jpg" placement="break"&gt;
    163. 

  163.   &lt;alt&gt;Alt&lt;/alt&gt;
    164. 

  164. &lt;/image&gt;
    165. 

  165. &lt;fig&gt;
    166. 

  166.   &lt;title&gt;Title&lt;/title&gt;
    167. 

  167.   &lt;image href="test.jpg"&gt;
    168. 

  168.     &lt;alt&gt;Alt&lt;/alt&gt;
    169. 

  169.   &lt;/image&gt;
    170. 

  170. &lt;/fig&gt;</code></pre></section>
    171. 

  171.     <section class="section" id="markdown-dita-syntax-reference__key-references"><h2 class="title sectiontitle">Key references</h2>
    172. 

  172.       
    173. 

  173.       <p class="p">Key reference can be used with
    174. 

  174.         <a class="xref" href="http://spec.commonmark.org/0.18/#shortcut-reference-link" target="_blank">shortcut
    175. 

  175.           reference
    176. 

  176.       links</a>:</p><pre class="pre codeblock language-markdown"><code>[key]
    177. 

  177. ![image-key]</code></pre><pre class="pre codeblock language-xml"><code>&lt;xref keyref="key"/&gt;
    178. 

  178. &lt;image keyref="image-key"/&gt;</code></pre></section>
    179. 

  179.     <section class="section" id="markdown-dita-syntax-reference__inline"><h2 class="title sectiontitle">Inline</h2>
    180. 

  180.       
    181. 

  181.       <p class="p">The following inline elements are
    182. 

  182.       supported:</p><pre class="pre codeblock language-markdown"><code>**bold**
    183. 

  183. *italic*
    184. 

  184. `code`
    185. 

  185. ~~strikethrough~~</code></pre><pre class="pre codeblock language-xml"><code>&lt;b&gt;bold&lt;/b&gt;
    186. 

  186. &lt;i&gt;italic&lt;/i&gt;
    187. 

  187. &lt;codeph&gt;code&lt;/codeph&gt;
    188. 

  188. &lt;ph status="deleted"&gt;strikethrough&lt;/ph&gt;</code></pre></section>
    189. 

  189.     <section class="section" id="markdown-dita-syntax-reference__lists"><h2 class="title sectiontitle">Lists</h2>
    190. 

  190.       
    191. 

  191.       <p class="p">Unordered can be marked up with either hyphen or ampersand:</p><pre class="pre codeblock language-markdown"><code>*   one
    192. 

  192. *   two
    193. 

  193.     -   three
    194. 

  194.     -   four</code></pre><pre class="pre codeblock language-xml"><code>&lt;ul&gt;
    195. 

  195.   &lt;li&gt;one&lt;/li&gt;
    196. 

  196.   &lt;li&gt;two
    197. 

  197.     &lt;ul&gt;
    198. 

  198.       &lt;li&gt;three&lt;/li&gt;
    199. 

  199.       &lt;li&gt;four&lt;/li&gt;
    200. 

  200.     &lt;/ul&gt;
    201. 

  201.   &lt;/li&gt;
    202. 

  202. &lt;/ul&gt;</code></pre>
    203. 

  203.       <p class="p">Ordered can be marked up with either number or number sign, followed by a period:</p><pre class="pre codeblock language-markdown"><code>1.  one
    204. 

  204. 2.  two
    205. 

  205.     #.  three
    206. 

  206.     #.  four</code></pre><pre class="pre codeblock language-xml"><code>&lt;ol&gt;
    207. 

  207.   &lt;li&gt;one&lt;/li&gt;
    208. 

  208.   &lt;li&gt;two
    209. 

  209.     &lt;ol&gt;
    210. 

  210.       &lt;li&gt;three&lt;/li&gt;
    211. 

  211.       &lt;li&gt;four&lt;/li&gt;
    212. 

  212.     &lt;/ul&gt;
    213. 

  213.   &lt;/li&gt;
    214. 

  214. &lt;/ul&gt;</code></pre>
    215. 

  215.       <p class="p">Definition lists use the
    216. 

  216.         <a class="xref" href="http://michelf.com/projects/php-markdown/extra/#def-list" target="_blank">PHP
    217. 

  217.           Markdown Extra</a> format:</p><pre class="pre codeblock language-markdown"><code>Term
    218. 

  218. :   Definition.</code></pre><pre class="pre codeblock language-xml"><code>&lt;dl&gt;
    219. 

  219.   &lt;delentry&gt;
    220. 

  220.     &lt;dt&gt;Term&lt;/dt&gt;
    221. 

  221.     &lt;dd&gt;Defintion.&lt;/dd&gt;
    222. 

  222.   &lt;/delentry&gt;
    223. 

  223. &lt;/dl&gt;</code></pre>
    224. 

  224.       <p class="p">Each definition entry must have only one term and contain only inline content.</p></section>
    225. 

  225.     <section class="section" id="markdown-dita-syntax-reference__tables"><h2 class="title sectiontitle">Tables</h2>
    226. 

  226.       
    227. 

  227.       <div class="div div-index">
    228. 

  228.         
    229. 

  229.       </div>
    230. 

  230.       <p class="p">Tables use
    231. 

  231.         <a class="xref" href="http://fletcherpenney.net/multimarkdown/" target="_blank">MultiMarkdown</a> table
    232. 

  232.         extension format:</p><pre class="pre codeblock language-markdown"><code>| First Header | Second Header | Third Header |
    233. 

  233. | ------------ | :-----------: | -----------: |
    234. 

  234. | Content      | *Long Cell*                 ||
    235. 

  235. | Content      | **Cell**      | Cell         |</code></pre><pre class="pre codeblock language-xml"><code>&lt;table&gt;
    236. 

  236.   &lt;tgroup cols="3"&gt;
    237. 

  237.     &lt;colspec colname="col1"/&gt;
    238. 

  238.     &lt;colspec colname="col2" align="center"/&gt;
    239. 

  239.     &lt;colspec colname="col3" align="right"/&gt;
    240. 

  240.     &lt;thead&gt;
    241. 

  241.       &lt;row&gt;
    242. 

  242.         &lt;entry&gt;First Header &lt;/entry&gt;
    243. 

  243.         &lt;entry&gt;Second Header &lt;/entry&gt;
    244. 

  244.         &lt;entry&gt;Third Header &lt;/entry&gt;
    245. 

  245.       &lt;/row&gt;
    246. 

  246.     &lt;/thead&gt;
    247. 

  247.     &lt;tbody&gt;
    248. 

  248.       &lt;row&gt;
    249. 

  249.         &lt;entry&gt;Content &lt;/entry&gt;
    250. 

  250.         &lt;entry namest="col2" nameend="col3"&gt;&lt;i&gt;Long Cell&lt;/i&gt;&lt;/entry&gt;
    251. 

  251.       &lt;/row&gt;
    252. 

  252.       &lt;row&gt;
    253. 

  253.         &lt;entry&gt;Content &lt;/entry&gt;
    254. 

  254.         &lt;entry&gt;&lt;b&gt;Cell&lt;/b&gt;&lt;/entry&gt;
    255. 

  255.         &lt;entry&gt;Cell &lt;/entry&gt;
    256. 

  256.       &lt;/row&gt;
    257. 

  257.     &lt;/tbody&gt;
    258. 

  258.   &lt;/tgroup&gt;
    259. 

  259. &lt;/table&gt;</code></pre>
    260. 

  260.       <p class="p">Table cells may only contain inline content and column spans; block content and row spans are not supported by
    261. 

  261.         Markdown DITA.</p></section>
    262. 

  262.     <section class="section" id="markdown-dita-syntax-reference__metadata"><h2 class="title sectiontitle">Metadata</h2>
    263. 

  263.       
    264. 

  264.       <div class="div div-index">
    265. 

  265.         
    266. 

  266.         
    267. 

  267.         
    268. 

  268.       </div>
    269. 

  269.       <p class="p">
    270. 

  270.         <a class="xref" href="http://www.yaml.org/" target="_blank">YAML</a> metadata block as defined in Pandoc
    271. 

  271.         <a class="xref" href="http://pandoc.org/MANUAL.html#extension-yaml_metadata_block" target="_blank">pandoc_metadata_block</a> can be used to specify different metadata elements. The supported elements
    272. 

  272.         are:</p>
    273. 

  273.       <ul class="ul">
    274. 

  274.         <li class="li">
    275. 

  275.           <p class="p"><code class="ph codeph">author</code></p></li>
    276. 

  276.         <li class="li">
    277. 

  277.           <p class="p"><code class="ph codeph">source</code></p></li>
    278. 

  278.         <li class="li">
    279. 

  279.           <p class="p"><code class="ph codeph">publisher</code></p></li>
    280. 

  280.         <li class="li">
    281. 

  281.           <p class="p"><code class="ph codeph">permissions</code></p></li>
    282. 

  282.         <li class="li">
    283. 

  283.           <p class="p"><code class="ph codeph">audience</code></p></li>
    284. 

  284.         <li class="li">
    285. 

  285.           <p class="p"><code class="ph codeph">category</code></p></li>
    286. 

  286.         <li class="li">
    287. 

  287.           <p class="p"><code class="ph codeph">keyword</code></p></li>
    288. 

  288.         <li class="li">
    289. 

  289.           <p class="p"><code class="ph codeph">resourceid</code></p></li>
    290. 

  290.       </ul>
    291. 

  291.       <p class="p">Unrecognized keys are output using <code class="ph codeph">data</code>
    292. 

  292.       element.</p><pre class="pre codeblock language-markdown"><code>---
    293. 

  293. author:
    294. 

  294.   - Author One
    295. 

  295.   - Author Two
    296. 

  296. source: Source
    297. 

  297. publisher: Publisher
    298. 

  298. permissions: Permissions
    299. 

  299. audience: Audience
    300. 

  300. category: Category
    301. 

  301. keyword:
    302. 

  302.   - Keyword1
    303. 

  303.   - Keyword2
    304. 

  304. resourceid:
    305. 

  305.   - Resourceid1
    306. 

  306.   - Resourceid2
    307. 

  307. workflow: review
    308. 

  308. ---
    309. 

  309. 

  310. # Sample with YAML header</code></pre><pre class="pre codeblock language-xml"><code>&lt;title&gt;Sample with YAML header&lt;/title&gt;
    311. 

  311. &lt;prolog&gt;
    312. 

  312.   &lt;author&gt;Author One&lt;/author&gt;
    313. 

  313.   &lt;author&gt;Author Two&lt;/author&gt;
    314. 

  314.   &lt;source&gt;Source&lt;/source&gt;
    315. 

  315.   &lt;publisher&gt;Publisher&lt;/publisher&gt;
    316. 

  316.   &lt;permissions view="Permissions"/&gt;
    317. 

  317.   &lt;metadata&gt;
    318. 

  318.     &lt;audience audience="Audience"/&gt;
    319. 

  319.     &lt;category&gt;Category&lt;/category&gt;
    320. 

  320.     &lt;keywords&gt;
    321. 

  321.       &lt;keyword&gt;Keyword1&lt;/keyword&gt;
    322. 

  322.       &lt;keyword&gt;Keyword2&lt;/keyword&gt;
    323. 

  323.     &lt;/keywords&gt;
    324. 

  324.   &lt;/metadata&gt;
    325. 

  325.   &lt;resourceid appid="Resourceid1"/&gt;
    326. 

  326.   &lt;resourceid appid="Resourceid2"/&gt;
    327. 

  327.   &lt;data name="workflow" value="review"/&gt;
    328. 

  328. &lt;/prolog&gt;</code></pre></section>
    329. 

  329.   </div>
    330. 

  330. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/alternative-input-formats.html" title="DITA-OT³ supports several alternative input formats in addition to standard DITA XML, including Markdown and the proposed XDITA, MDITA and HDITA authoring formats currently in development for Lightweight DITA.">Alternative authoring formats</a></div></div><div class="linklist relinfo"><strong>Related information</strong><br><ul class="linklist"><li class="linklist"><a class="link" href="../topics/markdown-input.html" title="Markdown is a lightweight markup language that allows you to write using an easy-to-read plain text format and convert to structurally valid markup as necessary.">Markdown content</a></li><li class="linklist"><a class="link" href="../topics/lwdita-input.html" title="DITA-OT provides preview support for the authoring formats proposed for Lightweight DITA, or “LwDITA”. The XDITA, MDITA and HDITA formats are alternative representations of DITA content in XML, Markdown and HTML5.">Preview support for Lightweight DITA</a></li></ul></div></nav></article></main></body></html>
    331.