author	date	title
Igor M. Coelho	April 8, 2020	ilectures-pandoc

Interactive Lectures on Pandoc

This is a tutorial exploring nice possibilities of using Pandoc for interactive lectures.

See avaiable topics:

• 0 - Setup (pandoc markdown) - PDF - Online
• 1 - Basics (pandoc markdown) - PDF - Online
• 2 - Plots (pandoc markdown) - PDF - Online
• 3 - Media (pandoc markdown) - PDF - Online
• 4 - Code (pandoc markdown) - PDF - Online
• 5 - Quiz (pandoc markdown) - PDF - Online
• 6 - Fun (pandoc markdown) - PDF - Online

Installation instructions

We provide some installation instructions on tutorials, specially on: 0 - Setup.

Currently, we consider the following packages:

• pandoc 2.9.2: Pandoc Website
• LaTeX
  • pdflatex: sudo apt-get install texlive-latex-base
  • beamer: sudo apt install texlive-latex-recommended
• Atom 1.45.0: Atom.io Website
• Atom plugin markdown-preview-enhanced 0.17.8: MPE Website
• Extras:
  • Anaconda3 conda 4.8.3 for plots (including plotly): Conda3 Download
  • cargo install pandoc-katex (install cargo/rust: https://www.rust-lang.org/tools/install)
    • https://github.com/xu-cheng/pandoc-katex
  • python3 -m pip install pandoc-latex-color
    • https://pypi.org/project/pandoc-latex-color/
  • pandoc-crossref (install cabal/haskell: sudo apt-get install haskell-platform)
    • we need cabal 3.0.0 at least
    • cabal update && cabal install Cabal cabal-install
    • ~/.cabal/bin/cabal v2-update
    • ~/.cabal/bin/cabal v2-install --install-method=copy pandoc pandoc-crossref pandoc-citeproc
    • https://github.com/lierdakil/pandoc-crossref.git
  • pandoc-source-exec (pip install pandoc-source-exec)
    • https://github.com/shoeffner/pandoc-source-exec
    • shoeffner/pandoc-source-exec#11

Some more installation instructions for Pandoc and Reveal.js can be found on:

• Pandoc Manual
• Pandoc Wiki: integration with reveal.js

VSCode plugins

We strongly recommend the plugins:

• markdown-preview-enhanced: amazing pandoc-markdown preview
• paste-image (mushan.vscode-paste-image): just type Ctrl+Alt+P "paste image" to add clipboard image to markdown automatically.

---

Demonstrations

• Lecture for Operations Research (in Portuguese) of Prof. Igor Machado Coelho (2020): https://igormcoelho.github.io/curso-pesquisa-operacional-i

Example of course number 3 (simplex), visualized on VSCode plugin.

---

Limitations

Some current limitations are listed here.

Extended Tables

Pandoc currently (04/2020) does not support Extended Tables (multi-columns and multi-rows), such as in MultiMarkdown format. Some issues:

• jgm/pandoc#1024
• https://stackoverflow.com/questions/30528217/table-layouts-for-use-with-pandoc
• https://stackoverflow.com/questions/39329602/multimarkdown-tables-with-pandoc

The current solution seems to do the table in HTML or LaTeX. To do both simultaneously, you can use our filter comments-to.py (implemented via pandocfilters on python).

Incremental items on Reveal.js/Beamer

When using double-columns together with incremental lists, these may be buggy on reveal.js (not displaying after button press). In these cases, avoid -i incremental option.

If necessary to do incremental items, it's better to use fenced_div surrounding it:

::: incremental

- item1
- item2

:::

And an alternative (older option do not require fenced_div):

> - item1
> - item2

---

MIT License - 2020