使用pandoc和reveal.js制作html演示文稿

在一个近期的项目中，需要制作一系列演示文稿。我习惯用github管理项目，演示文稿如果使用常见的ppt格式，这个文件只有下载后打开才能看到内容。如果能使用markdown书写，再转换成可以浏览器播放的演示文稿就方便了，既便于内容的查看与编辑，又摆脱了臃肿的office软件。解决方案是使用markdown语言书写，再使用pandoc转换为reveal.js播放的文稿。

pandoc是文档格式转换的神器，几乎能转换你所知道的任何文档格式。reveal.js是使用html播放演示文稿的js框架库。

假设我们已经有下面的markdown文件，需要转为演示文档：

% Habits
% John Doe
% March 22, 2005

# In the morning

## Getting up

- Turn off alarm
- Get out of bed

## Breakfast

- Eat eggs
- Drink coffee

# In the evening

## Dinner

- Eat spaghetti
- Drink wine

------------------

![picture of spaghetti](images/spaghetti.jpg)

## Going to sleep

- Get in bed
- Count sheep

我们首先需要下载安装pandoc，这个页面可以下载安装包。如果你是windows系统，安装后还需要将pandoc路径增加到环境变量中。然后我们在这个页面下载reveal.js，解压后目录名称由reveal.js-master修改为reveal.js并放置于上面的markdown相同目录下。

下面在命令行模式下运行：

pandoc -t revealjs -s demo.txt -o demo.html

这里的参数-t告诉pandoc转换的目标格式为reveal.js，-s指明源文件为demo.txt，-o指明输出文件为demo.html。

如果reveal.js所在目录与markdown文件不同，可以通过参数 -V revealjs-url指定。如以下参数指定使用官方网站url：

... -V revealjs-url=https://revealjs.com ...

运行命令后，我们发现目录下生成了名为demo.html的文件，使用浏览器打开：

刚才生成的网页使用的是默认theme，可选的themes有以下几种：

• beige
• black
• blood
• league
• moon
• night
• serif
• simple
• sky
• solarized
• white

可以使用以下参数指定theme：

... -V theme=$theme ...