Markdown and DocBook


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.



<?xml version="1.0" encoding="utf-8"?>
<article xmlns:xi="">
  <title>Test xinclude markdown</title>
  <xi:include href=""/>    

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  

<project name="docbook-markdown" default="docbook-and-markdown"> 

  <taskdef name="dbk" 

  <!-- xinclude markdown -->
  <target name="xinclude-markdown"> 
    <dbk file="docbook-markdown.xml" tofile="docbook-markdown.pdf" />

  <!-- or process markdown -->
  <target name="process-markdown"> 
    <dbk file="" tofile="markdown.html" />


see: docbook-markdown.pdf