Halaman utama Jelajahi Bantuan
Masuk
bn
/
se
2
0
Fork 0
Berkas Masalah 0 Permintaan Tarik 0 Wiki
Pohon: 1dd225b210
Ranting Tag
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.0.4
/
doc
/
topics
/
markdown-dita-syntax-reference.html

markdown-dita-syntax-reference.html 18 KB
Riwayat Mentahan

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317 
  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 2018"><meta name="DC.rights.owner" content="(C) Copyright 2018"><meta name="DC.Type" content="topic"><meta name="description" content="Markdown DITA uses CommonMark as the underlying markup language."><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.0</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/extending-the-ot.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.   <div class="body"><p class="shortdesc">Markdown DITA uses
    12. 

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

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

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

  15.       
    16. 

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

  17.       <pre class="pre codeblock markdown"><code># Topic title
    18. 

  18. 

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

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

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

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

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

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

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

  26.         <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
    27. 

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

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

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

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

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

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

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

  34. 

  35. # Topic title
    36. 

  36. 

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

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

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

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

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

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

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

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

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

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

  47.       
    48. 

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

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

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

  51.       
    52. 

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

  53.         <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>
    54. 

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

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

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

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

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

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

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

  61.       </ul>
    62. 

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

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

  64. 

  65. Context
    66. 

  66. 

  67. 1.  Command
    68. 

  68. 

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

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

  71.   &lt;taskbody&gt;
    72. 

  72.     &lt;context&gt;
    73. 

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

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

  75.     &lt;steps&gt;
    76. 

  76.       &lt;step&gt;
    77. 

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

  78.         &lt;info&gt;
    79. 

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

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

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

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

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

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

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

  86.       
    87. 

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

  88.         <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>
    89. 

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

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

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

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

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

  94.       </ul>
    95. 

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

  96.         <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
    97. 

  97.         <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>
    98. 

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

  99. 

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

  101. 

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

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

  104.   &lt;body&gt;
    105. 

  105.     &lt;section&gt;
    106. 

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

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

  108.     &lt;example&gt;
    109. 

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

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

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

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

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

  114.       
    115. 

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

  116.         DITA files:</p><table class="table"><caption></caption><colgroup><col><col></colgroup><thead class="thead">
    117. 

  117.             <tr class="row">
    118. 

  118.               <th class="entry" id="markdown-dita-syntax-reference__links__entry__1">extension</th>
    119. 

  119.               <th class="entry" id="markdown-dita-syntax-reference__links__entry__2">format</th>
    120. 

  120.             </tr>
    121. 

  121.           </thead><tbody class="tbody">
    122. 

  122.             <tr class="row">
    123. 

  123.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__1 "><code class="ph codeph">.dita</code></td>
    124. 

  124.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__2 "><code class="ph codeph">dita</code></td>
    125. 

  125.             </tr>
    126. 

  126.             <tr class="row">
    127. 

  127.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__1 "><code class="ph codeph">.xml</code></td>
    128. 

  128.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__2 "><code class="ph codeph">dita</code></td>
    129. 

  129.             </tr>
    130. 

  130.             <tr class="row">
    131. 

  131.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__1 "><code class="ph codeph">.md</code></td>
    132. 

  132.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__2 "><code class="ph codeph">markdown</code></td>
    133. 

  133.             </tr>
    134. 

  134.             <tr class="row">
    135. 

  135.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__1 "><code class="ph codeph">.markdown</code></td>
    136. 

  136.               <td class="entry" headers="markdown-dita-syntax-reference__links__entry__2 "><code class="ph codeph">markdown</code></td>
    137. 

  137.             </tr>
    138. 

  138.           </tbody></table>
    139. 

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

  140.         Absolute links targets are treated as external scope
    141. 

  141.       links:</p><pre class="pre codeblock markdown"><code>[Markdown](test.md)
    142. 

  142. [DITA](test.dita)
    143. 

  143. [HTML](test.html)
    144. 

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

  145. &lt;xref href="test.dita"&gt;DITA&lt;/xref&gt;
    146. 

  146. &lt;xref href="test.html" format="html"&gt;HTML&lt;/xref&gt;
    147. 

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

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

  149.       
    150. 

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

  151.         be treated as an image wrapped in
    152. 

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

  153. 

  154. ![Alt](test.jpg)
    155. 

  155. 

  156. ![Alt](test.jpg "Title")</code></pre><pre class="pre codeblock 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;
    157. 

  157. &lt;image href="test.jpg" placement="break"&gt;
    158. 

  158.   &lt;alt&gt;Alt&lt;/alt&gt;
    159. 

  159. &lt;/image&gt;
    160. 

  160. &lt;fig&gt;
    161. 

  161.   &lt;title&gt;Title&lt;/title&gt;
    162. 

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

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

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

  165. &lt;/fig&gt;</code></pre></section>
    166. 

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

  167.       
    168. 

  168.       <p class="p">Key reference can be used with
    169. 

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

  170.           reference
    171. 

  171.       links</a>:</p><pre class="pre codeblock markdown"><code>[key]
    172. 

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

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

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

  175.       
    176. 

  176.       <p class="p">The following inline elements are
    177. 

  177.       supported:</p><pre class="pre codeblock markdown"><code>**bold**
    178. 

  178. *italic*
    179. 

  179. `code`
    180. 

  180. ~~strikethrough~~</code></pre><pre class="pre codeblock xml"><code>&lt;b&gt;bold&lt;/b&gt;
    181. 

  181. &lt;i&gt;italic&lt;/i&gt;
    182. 

  182. &lt;codeph&gt;code&lt;/codeph&gt;
    183. 

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

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

  185.       
    186. 

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

  187. *   two
    188. 

  188.     -   three
    189. 

  189.     -   four</code></pre><pre class="pre codeblock xml"><code>&lt;ul&gt;
    190. 

  190.   &lt;li&gt;one&lt;/li&gt;
    191. 

  191.   &lt;li&gt;two
    192. 

  192.     &lt;ul&gt;
    193. 

  193.       &lt;li&gt;three&lt;/li&gt;
    194. 

  194.       &lt;li&gt;four&lt;/li&gt;
    195. 

  195.     &lt;/ul&gt;
    196. 

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

  197. &lt;/ul&gt;</code></pre>
    198. 

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

  199. 2.  two
    200. 

  200.     #.  three
    201. 

  201.     #.  four</code></pre><pre class="pre codeblock xml"><code>&lt;ol&gt;
    202. 

  202.   &lt;li&gt;one&lt;/li&gt;
    203. 

  203.   &lt;li&gt;two
    204. 

  204.     &lt;ol&gt;
    205. 

  205.       &lt;li&gt;three&lt;/li&gt;
    206. 

  206.       &lt;li&gt;four&lt;/li&gt;
    207. 

  207.     &lt;/ul&gt;
    208. 

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

  209. &lt;/ul&gt;</code></pre>
    210. 

  210.       <p class="p">Definition lists use the
    211. 

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

  212.           Markdown Extra</a> format:</p><pre class="pre codeblock markdown"><code>Term
    213. 

  213. :   Definition.</code></pre><pre class="pre codeblock xml"><code>&lt;dl&gt;
    214. 

  214.   &lt;delentry&gt;
    215. 

  215.     &lt;dt&gt;Term&lt;/dt&gt;
    216. 

  216.     &lt;dd&gt;Defintion.&lt;/dd&gt;
    217. 

  217.   &lt;/delentry&gt;
    218. 

  218. &lt;/dl&gt;</code></pre>
    219. 

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

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

  221.       
    222. 

  222.       <p class="p">Tables use
    223. 

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

  224.         extension format:</p><pre class="pre codeblock markdown"><code>| First Header | Second Header | Third Header |
    225. 

  225. | ------------ | :-----------: | -----------: |
    226. 

  226. | Content      | *Long Cell*                 ||
    227. 

  227. | Content      | **Cell**      | Cell         |</code></pre><pre class="pre codeblock xml"><code>&lt;table&gt;
    228. 

  228.   &lt;tgroup cols="3"&gt;
    229. 

  229.     &lt;colspec colname="col1"/&gt;
    230. 

  230.     &lt;colspec colname="col2" align="center"/&gt;
    231. 

  231.     &lt;colspec colname="col3" align="right"/&gt;
    232. 

  232.     &lt;thead&gt;
    233. 

  233.       &lt;row&gt;
    234. 

  234.         &lt;entry&gt;First Header &lt;/entry&gt;
    235. 

  235.         &lt;entry&gt;Second Header &lt;/entry&gt;
    236. 

  236.         &lt;entry&gt;Third Header &lt;/entry&gt;
    237. 

  237.       &lt;/row&gt;
    238. 

  238.     &lt;/thead&gt;
    239. 

  239.     &lt;tbody&gt;
    240. 

  240.       &lt;row&gt;
    241. 

  241.         &lt;entry&gt;Content &lt;/entry&gt;
    242. 

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

  243.       &lt;/row&gt;
    244. 

  244.       &lt;row&gt;
    245. 

  245.         &lt;entry&gt;Content &lt;/entry&gt;
    246. 

  246.         &lt;entry&gt;&lt;b&gt;Cell&lt;/b&gt;&lt;/entry&gt;
    247. 

  247.         &lt;entry&gt;Cell &lt;/entry&gt;
    248. 

  248.       &lt;/row&gt;
    249. 

  249.     &lt;/tbody&gt;
    250. 

  250.   &lt;/tgroup&gt;
    251. 

  251. &lt;/table&gt;</code></pre>
    252. 

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

  253.         Markdown DITA.</p></section>
    254. 

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

  255.       
    256. 

  256.       <p class="p">
    257. 

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

  258.         <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
    259. 

  259.         are:</p>
    260. 

  260.       <ul class="ul">
    261. 

  261.         <li class="li">
    262. 

  262.           <p class="p"><code class="ph codeph">author</code></p></li>
    263. 

  263.         <li class="li">
    264. 

  264.           <p class="p"><code class="ph codeph">source</code></p></li>
    265. 

  265.         <li class="li">
    266. 

  266.           <p class="p"><code class="ph codeph">publisher</code></p></li>
    267. 

  267.         <li class="li">
    268. 

  268.           <p class="p"><code class="ph codeph">permissions</code></p></li>
    269. 

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

  270.           <p class="p"><code class="ph codeph">audience</code></p></li>
    271. 

  271.         <li class="li">
    272. 

  272.           <p class="p"><code class="ph codeph">category</code></p></li>
    273. 

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

  274.           <p class="p"><code class="ph codeph">keyword</code></p></li>
    275. 

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

  276.           <p class="p"><code class="ph codeph">resourceid</code></p></li>
    277. 

  277.       </ul>
    278. 

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

  279.       element.</p><pre class="pre codeblock markdown"><code>---
    280. 

  280. author:
    281. 

  281.   - Author One
    282. 

  282.   - Author Two
    283. 

  283. source: Source
    284. 

  284. publisher: Publisher
    285. 

  285. permissions: Permissions
    286. 

  286. audience: Audience
    287. 

  287. category: Category
    288. 

  288. keyword:
    289. 

  289.   - Keyword1
    290. 

  290.   - Keyword2
    291. 

  291. resourceid:
    292. 

  292.   - Resourceid1
    293. 

  293.   - Resourceid2
    294. 

  294. workflow: review
    295. 

  295. ---
    296. 

  296. 

  297. # Sample with YAML header</code></pre><pre class="pre codeblock xml"><code>&lt;title&gt;Sample with YAML header&lt;/title&gt;
    298. 

  298. &lt;prolog&gt;
    299. 

  299.   &lt;author&gt;Author One&lt;/author&gt;
    300. 

  300.   &lt;author&gt;Author Two&lt;/author&gt;
    301. 

  301.   &lt;source&gt;Source&lt;/source&gt;
    302. 

  302.   &lt;publisher&gt;Publisher&lt;/publisher&gt;
    303. 

  303.   &lt;permissions view="Permissions"/&gt;
    304. 

  304.   &lt;metadata&gt;
    305. 

  305.     &lt;audience audience="Audience"/&gt;
    306. 

  306.     &lt;category&gt;Category&lt;/category&gt;
    307. 

  307.     &lt;keywords&gt;
    308. 

  308.       &lt;keyword&gt;Keyword1&lt;/keyword&gt;
    309. 

  309.       &lt;keyword&gt;Keyword2&lt;/keyword&gt;
    310. 

  310.     &lt;/keywords&gt;
    311. 

  311.   &lt;/metadata&gt;
    312. 

  312.   &lt;resourceid appid="Resourceid1"/&gt;
    313. 

  313.   &lt;resourceid appid="Resourceid2"/&gt;
    314. 

  314.   &lt;data name="workflow" value="review"/&gt;
    315. 

  315. &lt;/prolog&gt;</code></pre></section>
    316. 

  316.   </div>
    317. 

  317. <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="As of release 3.0, DITA-OT supports several alternative input formats in addition to standard DITA XML, including Markdown and the proposed 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 MDITA and HDITA authoring formats proposed for Lightweight DITA, or “LwDITA”. These proposed formats are alternative representations of DITA content in Markdown or HTML.">Preview support for Lightweight DITA</a></li></ul></div></nav></article></main></body></html>
    318.