hubgit / pandoc

GitHub action to run pandoc

GitHub Action to Convert Documents via Pandoc

This action lets you use pandoc, the swiss army knife of document conversion.

It is based on the pandoc/latex docker image and thus ships with LaTeX, so you can also convert right through to PDF.

The action currently uses pandoc 2.6 and will be upgrade periodically. If you would like to see an upgrade, please file an issue.

Inputs

None.

Outputs

None.

Secrets

None.

Environment Variables

None.

Example Usage

The string passed to args gets appended to the pandoc command.

name: Convert README to PDF

on: [push]

jobs:
  convert_via_pandoc:
    name: Convert via Pandoc
    runs-on: ubuntu-18.04
    steps:
      - uses: actions/checkout@v1
      - run: mkdir output
      - uses: maxheld83/pandoc@v2
        with:
          args: "--pdf-engine=xelatex --output=output/README.pdf README.md"
      - uses: actions/upload-artifact@master
        with:
          name: output
          path: output