From pandoc to ConTeXt

compiling pandoc XHTML with ConTeXt

This project is maintained by ousia


pandoc-xhtml.tex offers a way to compile Markdown documents with ConTeXt.

pandoc-xhtml.tex is an environment, which is what ConTeXt needs to compile XML sources directly.

With the proper environment, ConTeXt deals with XML natively. It doesn’t need any intermediate format. Not even a ConTeXt source file cotaining the text to be typeset.

What Is Wrong with ConTeXt Sources?

pandoc can generate ConTeXt documents from Markdown sources. But this way you’ll miss:

Generating the PDF document from XML sources with ConTeXt avoids loosing relevant information (such as language, which result in wrong hyphenation) or special layout for block or inline elements.

Going this way, the Mardown source document may fullfill the promise:

One source to generate them all.


This project is still work in progress. I have used myself to publish a book and some other documents. It fits my needs.

Of course, my documents may contain code, but no math. My texts contain some expressions in foreign languages and some code.

The documentation needs some polishing to be released. I hope to have it finished by the end of June 2015.

If you find something that can be improved or you want to comment anything related to the project, please open an issue.


The environment file from this project (pandoc-xhtml.tex) is licensed to the public under the GNU General Public License; either version 2, or (at your option) any later version.

The documentation is released under the Creative Commons Attribution–ShareAlike 4.0 International license.


This work was based on the extraordinary achievements of John MacFarlane and Hans Hagen.

I want to thank them for their software and their help.