文档转换界的瑞士军刀之pandoc简介

2019-01-14 本文已影响10人 TauJiong

本文首发于我的博客，更多精彩内容请移步Brayn的博客

最近在研究怎样优雅地写毕业论文，无意间看到了pandoc配合markdown完成论文排版的文章，很有趣，故此分享在这里。

简介

Pandoc是一款能够高质量转换文档格式的本地转换工具，其支持的语言十分丰富，而且转换后能够保持格式的完整性。

根据官方介绍，其支持的文档转换格式有：
FROM
Markdown, reStructuredText, textile, HTML, DocBook, LaTeX, MediaWiki markup, TWiki markup, TikiWiki markup, Creole 1.0, Vimwiki markup, roff man, OPML, Emacs Org-Mode, Emacs Muse, txt2tags, Microsoft Word docx, LibreOffice ODT, EPUB, or Haddock markup

HTML formats
XHTML, HTML5, and HTML slide shows using Slidy, reveal.js, Slideous, S5, or DZSlides
Word processor formats
Microsoft Word docx, OpenOffice/LibreOffice ODT, OpenDocument XML, Microsoft PowerPoint.
Ebooks
EPUB version 2 or 3, FictionBook2
Documentation formats
DocBook version 4 or 5, TEI Simple, GNU TexInfo, roff man, roff ms, Haddock markup
Archival formats
JATS
Page layout formats
InDesign ICML
Outline formats
OPML
TeX formats
LaTeX, ConTeXt, LaTeX Beamer slides
PDF
via pdflatex, xelatex, lualatex, pdfroff, wkhtml2pdf, prince, or weasyprint.
Lightweight markup formats
Markdown (including CommonMark and GitHub-flavored Markdown), reStructuredText, AsciiDoc, Emacs Org-Mode, Emacs Muse, Textile, txt2tags, MediaWiki markup, DokuWiki markup, TikiWiki markup, TWiki markup, Vimwiki markup, and ZimWiki markup.
Custom formats
custom writers can be written in lua.

我们经常使用的文档格式已着重标出。需要注意的是，转换到pdf格式需要LaTeX引擎的支持，而且由于pdf格式的特殊性，不能从pdf格式转出。

以下图片引起极度舒适，请小心食用。

pandoc支持格式

安装

简单粗暴的方法

官网下载

命令行方式

Windows + chocolatey

#安装主程序
choco install pandoc

#安装相关依赖包
choco install rsvg-convert python miktex

Mac + homebrew

#安装homebrew
    #强烈推荐，已安装则跳过此步
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

#安装主程序
brew install pandoc

#安装论文引用插件
brew install pandoc-citeproc

#安装LaTeX支持
brew install librsvg python homebrew/cask/basictex

使用

在Mac终端 / Windows命令提示行窗口使用cd命令定位到目标文件所在文件夹
pandoc演示
输入pandoc [optional] input.txt -o output.docx
[optional]部分是可选命令，能引入插件实现更多功能。
input.txt是待转换文件
output.docx是欲转换的格式，名字可以自定义。
转换命令