Pandoc Markdown and Publishing - overlord-supreme/checkers GitHub Wiki

Converting multiple Markdown files with links to PDF

pandoc *.md -o result.pdf

Converting Markdown to PDF or DOCX with Pandoc

pandoc -s -o doc.html part01.md part02.md

Pandoc Homepage

Using Pandoc

  • download pandoc
  • write up files in markdown
  • convert to rtf (rich text format)
  • export to pdf (portable document format)
pandoc test.md --bibliography testlibrary.bib --smart --normalize -s -o success.rtf

Academic Writing in Markdown

  • note, this is not Github-flavored Markdown, which you may be more familiar with

Madoko: a scholarly markdown

  • might be interesting to mess with
  • adds a bunch of features, styles nicely

MkDocs: Homepage

  • many FOSS projects use this
pip install mkdocs # installs mkdocs
mkdocs new docs # creates new project
# `$pwd = docs`
py -m mkdocs build --clean # builds the documentation (`md` -> `html`)
py -m mkdocs serve # serves it on port `8080`

MkDocs PDF Export Plugin

  • way of styling and exporting the above

Markdown and including multiple files

pandoc *.md > book.html

Building Docs Like Code: Continuous Integration for Documentation

Markdown CSS

MarkedStyle

Markdown CSS