{"repo":"pandoc/pandoc-action-example","free":true,"listed":false,"github":"https://github.com/pandoc/pandoc-action-example","clone":"git clone https://github.com/pandoc/pandoc-action-example.git","description":"using the pandoc document converter on GitHub Actions","language":null,"stars":422,"topics":["pandoc","latex","markdown","html","continuous-delivery","continuous-integration","github-actions"],"license":null,"category":"deployment-docker-iac","readme_excerpt":"Using pandoc with GitHub Actions You can use pandoc, the universal markup converter , on GitHub Actions to convert documents. GitHub Actions is an Infrastructure as a Service (IaaS) from GitHub, that allows you to automatically run code on GitHub's servers on every push (or a bunch of other GitHub events). For example, you can use GitHub Actions to convert some file.md to file.pdf (via LaTeX) and upload the results to a web host. Using docker://pandoc Images Directly You can now directly reference container actions on GitHub Actions. You do not need a separate GitHub Action. If you need LaTeX (because you want to convert through to PDF), you should use the docker://pandoc/latex image. Otherwise, the smaller docker://pandoc/core will suffice. It is a good idea to be explicit about the pandoc version you require, such as docker://pandoc/core:3.8 . This way, any future breaking changes in pandoc will not affect your workflow. You can find out whatever the latest released docker image is on docker hub. You should avoid specifying no tag or the latest tag -- these will float to the latest image and will expose your workflow to potentially breaking changes. Simple Usage You can use pandoc inside GitHub actions exactly as you would use it on the command line. The string passed to args gets appended to the pandoc command. The below example is equivalent to running pandoc --help . You can see it in action here. Long Pandoc Calls Remember that as per the GitHub Actions workflow syntax,","default_branch":null,"files":null,"tree":[],"storefront":"/r/pandoc","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/pandoc/pandoc-action-example/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}