1

$ pandoc <files> <options>

其中 <files> 为输入的内容，其输入即可以来自文件，也可以来自标准输入甚至网页链接。而 <options> 为参数选项。主要的参数选项有：

虽然 Pandoc 提供了用于指定输入输出格式的参数，但是很多时候该参数不必使用。Pandoc 已经足够聪明到可以根据文件名判断输入输出格式，所以除非文件名可能造成歧义，否则这两个参数都可以省略。

1

$ pandoc --list-input-formats

查看程序支持代码高亮的编程语言：

1

$ pandoc --list-highlight-languages

查看程序帮助：

1

$ pandoc --help

1

$ pandoc demo.md -o demo.html

上面的命令将输出一个 HTML 文档，但该文档不包含任何样式，它的显示效果依赖于你使用的浏览器。我们当然希望可以得到排版更精美的文档，只要在转换时引入自己的层叠样式表 CSS 文件。输入的 CSS 文件可使用 -c 命令来指定：

1

$ pandoc demo.md -c style.css -o demo.html

如此输出的 HTML 文档已经包含样式文档了，平时自己查看时，效果很不错。但该方式依然存在部分问题。我们发布或共享文档时，需要传送至少两个文件：1 个 HTML 文件和 1 个 CSS 文件，略有些不便。而如果文档中还包含多个本地图片等文件，共享文档几乎成了不可能的事情。好在 Pandoc 可以将外部文件嵌入到 HTML 文档中，生成一个自包含的独立文件：

1

$ pandoc demo.md --self-contained -c style.css -o demo.html

在该命令中， --self-contained 参数指定：将任何的外部文件嵌入至输出的文件中，形成一个独立的 HTML 文档。这样传送资料时只传送一个文件就可以了，就像分享 PDF 文档一样方便。

下面的命令将一份 Markdown 文件转换为 docx 格式：

1

$ pandoc demo.md -o demo.docx

下面的命令将 HTML 网页转换为 docx 格式：

1

$ pandoc http://gnss.help/2017/06/12/pandoc-install-usage/ -o this_page.docx

需补充的是：Pandoc 无法为生成的 Word docx 文档指定排版方式。你可能需要二次编辑输出的文件，将标题、正文等调整为满意的样式。

1

$ pandoc demo.md -o demo.pdf

我生成 PDF 文档时，未使用以上的方法。而是采用 HTML 文件作为中间文件过渡，使用 Windows 系统的 “打印到 PDF” 功能，将 HTML 文档进一步转换为所需的 PDF 文档。

下面的命令由 Word docx 文档生成 Markdown 文件：

1

$ pandoc demo.docx -o demo.md

下面的命令由 HTML 网页生成 Markdown 文档：

1

$ pandoc http://gnss.help/2017/06/12/pandoc-install-usage/ -o this_page.md