Yes, it really is that easy.
Everything else just happens once you have it set up.
Markdown is plain text with formatting syntax designed so that it can be converted to HTML and many other formats. Markdown is often used to format readme files, for writing messages in online discussion forums, and to create rich text using a plain text editor.
There is a download file just for you at: Pandoc Install
Output to PDF requires LaTeX.
Pandoc is run from the command line. This is not a tutorial on how to use the command line. If you are unsure of your command line skills, try one of the many excellent tutorials available though a Google search.
I happen to be running this via Windows PowerShell but the commands are identical to a Linux BASH.
pandoc -t html5 --template=templatecdn_revealjs.html --standalone --section-divs pandoc_reveal.md -o pandoc_reveal.html
Pandoc has many options, see
cd my_working_directory: Change directory to my_working_directory. my_working_directory is where my files and templates are stored.
pandoc arguments: Calls Pandoc with the specified arguments
Create excellent presentation slides using HTML. The easiest way to understand what it does is to see the demonstration.
Pandoc comes with a default reveal.js template, called with the output FORMAT set to revealjs. Example:
pandoc -t revealjs --standalone input.md -o output.html
I prefer to use my own custom template. This template is available in the repository as template_revealjs.html.
Why? The custom template adds many new variables, i.e. the GitHub variables, outputs HTML5, and increases the configuration coverage for reveal.js.
pandoc -t html5 --standalone --section-divs --template=template_revealjs.html pandoc_reveal.md -o pandoc_reveal.html
The custom template is intended for use with an appropriate markdown file that includes YAML variables.
Use template_md_reveal.md gist as your starting point markdown file.
YAML is basically a variable: value format that may be used to set configuration values for pandoc and reveal.js.
# THIS IS YAML
title: Main Title
author: Author Name
date: 10 July 2015
license: Apache License, Version 2.0
There may be more than one YAML block in a document. Each YAML block must start and end with 3 dashes. See Extension: yaml_metadata_block. Each variable that you set in YAML is available for use in the template.
My template_md_reveal.md uses 2 YAML blocks, one at the top and one at the bottom of the file. The top YAML sets some generic variables. The bottom YAML sets configuration values for reveal.js.
Create easy to maintain, share, and edit markdown files and turn them into feature-rich slideshows using pandoc and reveal.js.