Section 36.4 Processing

The pretext/pretext script (Chapter 48) performs these conversions with the formats text and markdown, for example

pretext/pretext -c doc -f markdown -p publication.xml book.ptx

A positive chunking level in the publication file produces a file per division; otherwise the result is a single file named for your source. A markdown build also deposits the directories of external and generated images alongside the markdown files, since the output references images at the same relative paths the HTML conversion uses. A third format, markdown-zip, bundles the entire markdown build, image directories included, into a single zip archive named for your source—convenient for handing a whole book to somebody (or something) else.