markdown_and_docbook.md

Markdown and DocBook {#markdown-and-docbook}

Description {#description}

Markdown is a lightweight markup languages

• easy to read,
• easy to write,
• easy to convert, (see ant + pandoc )
• easy to xinclude in docbook documents. This is (one of) the aim of ant4docbook.

Examples {#examples}

docbook-markdown.xml

<article xmlns:xi="http://www.w3.org/2001/XInclude"&gt;__&lt;title&gt;Test xinclude markdown</title><xi:include href="docbook-markdown.md"/>__</article>

docbook-markdown.md

A First Level Header_====================A Second Level Header---------------------Now is the time for all good men to come to__the aid of their country. This is just a__regular paragraph.The quick brown fox jumped over the lazy__dog's back.### Header 3> This is a blockquote.>> This is the second paragraph in the blockquote.>> ## This is an H2 in a blockquote_

build.xml

<project name="docbook-markdown" default="docbook-and-markdown"><taskdef name="dbk"classname="net.sourceforge.ant4docbook.taskdefs.DocbookTask"classpath="PATH/TO/ant4docbook.jar"/><target name="xinclude-markdown"><dbk file="docbook-markdown.xml" tofile="docbook-markdown.pdf" /></target><target name="process-markdown"><dbk file="markdown.md" tofile="markdown.html" /></target></project>

see: docbook-markdown.pdf