Skip to content

drehak/pandoc-to-markdown

Repository files navigation

Pandoc to Markdown Bridge

This repository contains a proof of concept for an upcoming package for TeX that will enable the use of Pandoc together with the Markdown package for TeX. For more information, see an article in the CSTUG Bulletin 31:1–4 (in Slovak, here is a machine translation to English) and an article in TUGboat 43:1 (see Section 2.3).

Important: Pandoc currently supports two styles of custom writers. The new style was introduced only in 2.17.2. The classic style, which this project uses, is currently deprecated and should be removed in version 3.0.0. Therefore, this project (in its current state) will not eventually work with newest versions of Pandoc.

To typeset the example documents, execute the following commands on a system with an up-to-date installation of TeX Live and Pandoc:

$ cd examples
$ make examples

Alternatively, you can use the witiko/markdown Docker image, which includes both TeX Live and Pandoc:

$ docker run --rm -it -v "$PWD":/workdir -w /workdir witiko/markdown \
> latexmk -shell-escape -pdf examples/example-man-pandoc.tex

See examples/ for the example documents.

The development of this package has been funded by the research project MUNI/33/1784/2020 (Extension of the input formats of the Markdown tool) funded by the Faculty of Informatics, Masaryk University.

All included documents except panda.md and wolf.1 belong to their respective authors and are only included for the purpose of demonstrating the functionality of this software.