使用Pandoc转换markdown等文本文档

核心提示：本文主要讲述使用Pandoc转换markdown等文本文档相关内容：本文介绍了使用Pandoc转换markdown等文本文档的方法，pandoc就是一个很好的文本格式转换器。pandoc这种格式转换器能把我们用markdown写成的书，转换成latex格式。然后对得到的latex做一些自定义处理，最终得到我们想要的pdf输出格式的过程。。

MarkDown 虽然写起来方便, 但是要预览的话还要用ReText打开, 很多人希望有一个把 markdown文件变成html格式 的工具，pandoc就是一个很好的文本格式转换器。pandoc这种格式转换器能把我们用markdown写成的书，转换成latex格式。然后对得到的latex做一些自定义处理，最终得到我们想要的pdf输出格式的过程。

Pandoc格式转换器介绍

基本说来，常用的格式pandoc都会支持。Pandoc输入格式可以是： MarkDown ,Textile, reStructuredText, HTML, LaTeX等，输出语言非常丰富，包括： markdown, reStructuredText, XHTML, HTML 5, LaTeX , ConTeXt,RTF, DocBook XML, OpenDocument XML, ODT, Word docx, GNU Texinfo, MediaWiki markup, EPUB, Textile, groff man, Emacs Org-Mode, AsciiDoc, Slidy, DZSlides, S5 HTML slide shows. 如果安装了 LaTeX ,甚至还可以输出为 PDF 格式！

当然，Pandoc Markdown不是万能的，表格、复杂公式、多国语言、上下标、交叉引用、图表对齐较多的场合，它并不适合。但是需要互动、实时展现、更快输出的场合，Pandoc Markdown等值得大力推荐。未来互联网会逼使写作趋简。需要更快发表、互动输出与交流的场合，也会越来越多。比如课堂作业、企业内部交流、个人博客。用它节省的时间是写作时比较关键的”创作时间”而非”排版时间”。

Pandoc使用方法

  1. 从 code.google.com/p/pandoc/downloads/list 下载适合操作系统的程序
  2. 安装的话，如果是windows，一路next就好了，会自动加入到system path里面
  3. 终端安装使用 sudo apt-get install pandoc
  4. pandoc是个命令行程序，所有操作通过命令行来完成

pandoc转换文本文档常用命令

常用参数

  • -f 输入格式（如果没有制定格式，则根据后缀名判断，如果没后缀名，则默认为markdown）
  • -t 输输出格式（默认为html）
  • -o 如果没有的话（默认是STDOUT）

Pandoc格式转换命令

a: 转换为html格式。这里—ascii可以避免转成utf-8编码，这样中文在浏览器上就不会乱码了。命令为

  1. pandoc -f markdown -t html higrid.net.txt -o newfile.html
  2. pandoc --ascii higrid.net.txt -o newfile.html

b: 转为pdf格式。注意，为了正确转换中文文本，请修改模板文件，在模板文件第一行下方加入 \usepackage{ctex} 命令为

  1. pandoc --latex-engine=xelatex yourfile.txt -o newfile.pdf

在windows 中使用时，新建文本文档，改后缀名为cmd，然后插入这样代码：

  1. cd
  2. pandoc -f markdown -t html in.txt -o out.html

保存后双击运行，就可以自动把当前目录下in.txt文件转换为out.html文件，非常方便！

详细的使用说明可以查找安装目录里面的 README.html 文件！看看帮助:

  1. $ pandoc -h
  2. pandoc [OPTIONS] [FILES]
  3. Input formats:  native, markdown, markdown+lhs, rst, rst+lhs, html, latex, latex+lhs
  4. Output formats:  native, html, html+lhs, s5, docbook, opendocument, odt, latex, latex+lhs, context, texinfo, man, markdown, markdown+lhs, plain, rst, rst+lhs, mediawiki, rtf
  5. Options:
  6.   -f FORMAT, -r FORMAT  --from=FORMAT, --read=FORMAT                    
  7.   -t FORMAT, -w FORMAT  --to=FORMAT, --write=FORMAT                     
  8.   -s                    --standalone                                    
  9.   -o FILENAME           --output=FILENAME                               
  10.   -p                    --preserve-tabs                                 
  11.                         --tab-stop=TABSTOP                              
  12.                         --strict                                        
  13.                         --reference-links                               
  14.   -R                    --parse-raw                                     
  15.   -S                    --smart                                         
  16.   -m[URL]               --latexmathml[=URL], --asciimathml[=URL]        
  17.                         --mathml[=URL]                                  
  18.                         --mimetex[=URL]                                 
  19.                         --jsmath[=URL]                                  
  20.                         --gladtex                                       
  21.   -i                    --incremental                                   
  22.                         --xetex                                         
  23.   -N                    --number-sections                               
  24.                         --no-wrap                                       
  25.                         --sanitize-html                                 
  26.                         --email-obfuscation=none|javascript|references  
  27.                         --id-prefix=STRING                              
  28.                         --indented-code-classes=STRING                  
  29.                         --toc, --table-of-contents                      
  30.                         --base-header-level=LEVEL                       
  31.                         --template=FILENAME                             
  32.   -V FILENAME           --variable=FILENAME                             
  33.   -c URL                --css=URL                                       
  34.   -H FILENAME           --include-in-header=FILENAME                    
  35.   -B FILENAME           --include-before-body=FILENAME                  
  36.   -A FILENAME           --include-after-body=FILENAME                   
  37.   -C FILENAME           --custom-header=FILENAME                        
  38.   -T STRING             --title-prefix=STRING                           
  39.                         --reference-odt=FILENAME                        
  40.   -D FORMAT             --print-default-template=FORMAT                 
  41.                         --data-dir=DIRECTORY                            
  42.                         --dump-args                                     
  43.                         --ignore-args                                   
  44.   -v                    --version                                       
  45.   -h                    --help

真是more than I’ve expected! markdown/rst/html/latex之间可以互转!

使用pandoc命令就可以在随便转换了, 示例, 把demo.md输出成demo.html:

  1. `$pandoc -f markdown -t html -o demo.html demo.md`