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

本文首发于我的博客,更多精彩内容请移步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

TO

  • 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简介_第1张图片
pandoc支持格式

安装

简单粗暴的方法

官网下载

命令行方式

  1. Windows + chocolatey
#安装主程序
choco install pandoc

#安装相关依赖包
choco install rsvg-convert python miktex
  1. 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

使用

  1. 在Mac终端 / Windows命令提示行窗口使用cd命令定位到目标文件所在文件夹
    文档转换界的瑞士军刀之pandoc简介_第2张图片
    pandoc演示
  2. 输入pandoc [optional] input.txt -o output.docx
    [optional]部分是可选命令,能引入插件实现更多功能。
    input.txt是待转换文件
    output.docx是欲转换的格式,名字可以自定义。
    文档转换界的瑞士军刀之pandoc简介_第3张图片
    转换命令

实例

  • 首先是我的md文档,包含大量的公式(基本的文字由于不能显示pandoc的强大就没有展示了)
文档转换界的瑞士军刀之pandoc简介_第4张图片
md文档
  • 这是基于md编译形成的pdf文档
文档转换界的瑞士军刀之pandoc简介_第5张图片
pdf文档
  • 最后这是转换形成的word文档
文档转换界的瑞士军刀之pandoc简介_第6张图片
word文档

进阶

  • 官方使用手册

  • 如何用markdown写论文

  • markdown进阶——阳志平

你可能感兴趣的:(文档转换界的瑞士军刀之pandoc简介)