#Markdown and Other Formats

If you want to turn markdown, wiki markup, docbook, and other formats into html, with working hyperlinks, then pandoc is your friend.
Install it, and then put this plugin in your config file.

    plugin {
        type = markdown
        desc = markdown file
        suffix = md
        content = application/markdown
        program = pandoc -f markdown -t html %i
        outtype = H
    }

With this in place, you can git clone this wiki, and read the files locally.
It's a lot less cluttered sans the github overhead.
Start with Home.md and off you go.
Also, many packages include md files in a README directory.
If you install software, you want to be able to read those.

Although pandoc can generate pdf, it doesn't read pdf, so you need another converter to render those.
This plugin requires down_url, because pdftohtml cannot take a url, it can only read a local file.
We must download the url into a temp file first.
In contrast, pandoc can read a url, so we can pull markdown from the internet and display it directly.
Well sometimes.
Pandoc understands http, but not https, so perhaps that plugin should contain down_url as well.

    plugin {
        type = pdf
        desc = pdf file
        suffix = pdf
        content = application/pdf
        down_url
        program = pdftohtml -i -noframes %i %o >/dev/null
        outtype = H
    }