pandoc把word转为html,利用 Pandoc 实现文档格式转换

应用场景

我喜欢用 Markdown 写文档，但不是所有读者都愿意花时间学习它，所以我需要将 Markdown 转换为他们习惯接受的格式，比如 docx 或 html；偶尔需要做幻灯片演示，也可以用 Markdown 来写，然后转换为幻灯片(Slideshow)。

Pandoc 的最基本的应用场景就是做这类转换。

当然，Pandoc 能做的远远不止这些。实际上它是一个非常强大的文档格式转换工具，支持数十种文档格式互转。至于有多强大，作者有张个图表，大家感受下。

本文仅以 Windows 平台为例介绍 Pandoc 最基础的应用方法。

安装使用

推荐在 Github Pandoc Releases 页面下载适合自己操作系统的最新版本安装包，一路按默认设置安装即可。

安装完看不到软件界面？别担心，一切都在命令行中完成！CTRL+R 输入 cmd进入命令提示符，运行下列命令：

pandoc --version

如果安装成功，可以看到 Pandoc 的当前版本和其他相关信息。

进入到 Pandoc 的工作目录，可能需要用到以下常用 cmd 命令：

进入F盘，直接运行 F:

查看子目录和文件，运行 dir

进入 myforder 文件夹，运行 cd myforder

进入上级目录，运行 cd ../

进入根目录，运行 cd /

按上下方向键可以快速键入前后输入的命令

Pandoc 命令格式

查看帮助，运行

pandoc --help

可以看到 Pandoc 的命令格式

基本格式

pandoc [options(选项)] [input-file(输入文件)]

文件转换示例

将 Markdown 格式转换为 Html。下面这条命令将 input.md 转为html并且输出为 output.html

pandoc -o output.html input.md

Pandoc 会自动根据文件扩展名判断文件格式，也可指定输入和输出文件格式：

pandoc -f markdown -t html -o output.html input.md

除了文件，还可以转换一个网页：

pandoc -f html -t markdown -o index.md http://miu.im

指定 css 样式，用到 -c 选项

pandoc -c style.css -o output.html input.md

生成独立的文件 (Standalone 模式)

pandoc -s -o output.html input.md

生成目录，--toc 可以自动提取 h1 - h6 并生成目录，使用--toc-depth 控制输出的目录级别，默认值是3，就是说会自动提取h1 - h3 作为输出文件的目录。

pandoc -c style.css -o output.html --toc --toc-depth=3 input.md

更多示例请参考官方 Demos 。

生成幻灯片

利用 Pandoc 可以方便生成 Html 幻灯片，类似 PowerPoint、Keynote的效果。目前 Pandoc 对以下几种 Html 幻灯框架支持：

这里我只介绍 reveal.js 的使用(我只用过这个..不过其他几个也大同小异 😳 )。

reveal.js 是一个非常流行的 Html 幻灯片框架，通过编辑 Html 创建幻灯片，不过直接编辑 Html 相当繁琐。使用 Pandoc 的好处就是，一条命令就可以解决问题，不需要编辑 Html。

准备 reveal.js

在 reveal.js Release 页面下载 reveal.js 2.6.2 源码包(目前 Pandoc 1.12 还不能很好支持 reveal.js 3.0.0，主要是指定主题风格无效，可手动调整)。

解压 reveal.js 至工作目录，将解压得到的文件夹重命名为 reveal.js (去掉版本号)。工作目录结构类似这样：

F:\workspace

│　slides.md

└─reveal.js

├─css

├─js

├─lib

├─plugin

└─test

Markdown 文件 slides.md 的内容如下：

% Nonsense Stuff

% 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

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


## Going to sleep

- Get in bed

- Count sheep

生成幻灯片

pandoc slides.md -o slides.html -t revealjs -s

指定主题，可以在 /css/theme 文件夹下查看支持的主题

pandoc slides.md -o slides.html -t revealjs -s -V theme=night

幻灯片级别

reveal.js 默认每个2级标题生成一个幻灯片，高于2级的标题(1级标题)生成一张独立的仅包含标题的幻灯片，而低于2级的标题(3级标题)将存在于上一级标题的幻灯片中，不单独生成新的幻灯片。

可以使用 --slide-level 选项覆盖默认的幻灯片级别，不过严重不推荐。

使用分割线可强制生成新的幻灯片，以下任意一种均可：

***

---

+++

逐条显示

生成幻灯片时加入 -i 选项，如果幻灯片中有列表，列表中每一项会逐条显示。

两段文字显示之间的人为停顿，用如下分割线：

. . .

幻灯片切换方式 transition， 可选切换方式有："default", "cube","page", "concave", "zoom", "linear", "fade", "none"

保存为完全独立文件 --self-contained。添加这个选项后会自动将需要的 css、js、图片、字体等资源都整合到一个单独的 html 中。(不过实测该选项有一些问题，还在摸索中...)

一个完整的示例，生成的幻灯片预览。

pandoc slides.md -o slides.html -t revealjs -s -i -V theme=night -V transition=default --toc --toc-depth=1

相关链接

参考链接