Pandoc-百变你的Markdown

我曾经多次把Markdown引入到部门的各个方面,好消息是现在部门已经普及了Markdown的意识,但是很多人还是只停留在会用这一层,其实利用Markdown可以做出很多更快捷的事情.

Pandoc为Markdown提供了一个更加快捷方便的道路.

那么Pandoc是什么呢

If you need to convert files from one markup format into another, pandoc is your swiss-army knife.

看看Pandoc支持转换的类型吧,来张吓尿你的图

其实日常学习工作中用到最多的也就是HTML,Markdown,doc,pdf的互相转换.

那么首先来看看如何安装吧.

Windows

  • 安装文件下载地址:pandoc
  • 如果你需要支持PDF,你需要安装MiKTeX

Mac (本文主要介绍Mac下的使用)

  • 安装文件下载地址:pandoc
  • 同样如果你需要支持PDF,你需要安装MacTeX,还需要使用tlmgr安装额外的包, 如果安装过程中出错了,可以尝试下下面的命令(谁说Mac好用的!)
tlmgr install collection-fontsrecommended

安装好了之后打开终端(控制台),输入pandoc --version,如果出现版本提示说明已经安装成功.

snip20141204_3

这里主要说一下如何利用Markdown为源文件来输出成html和word格式.

随便找出一个Markdown文件,终端里定位到当前Markdown文件的路径,首先我们想把这个Markdown文件demo.md转化成html

先来看下我们的Markdown原始文件是啥样吧

snip20141204_4

现在我们在终端里输入pandoc demo.md -o demo.html,转化成功是没有提示的,这时当前文件夹下会生成一个demo.html的文件,

snip20141204_6

妈蛋,为什么这么丑!因为没有任何修饰,自然比较丑啦,那么再来看下word的表现,同样在终端里输入pandoc demo.md -o demo.docx

snip20141204_8

可以看到输出的效果比html好了一个档次,但是有没有自己定义的方式呢?但是是肯定的.下面我们来自己定义下输出的样式

创建一个css文件,里面针对常用Markdown常用标签写了很多样式,把这个css文件另存为style.css放置在demo.md同级别的目录下.然后在终端里输入

pandoc -s -H style.css demo.md -o demo.html

可以看到展示的效果比之前美观了

snip20141204_9

然后我们输出一版word看下,pandoc -s -H style.css demo.md -o demo.docx,因为中文存在着一些编码和字体问题,所以一般情况下建议输出两个版本,一个docx一个doc,这样会更安全些,pandoc -s -H style.css demo.md -o demo.doc,来看下展示效果,基本上和经过style.css修饰过的demo.html一致了.

snip20141204_10

现在基本上就做到了一个Markdown文件,可以用很多种方式去表现出来,更多的方式可以到Pandoc - Demos去查看,另外Pandoc还提供了在线版Try pandoc!,虽然效果不是很理想,排版不复杂的文档转化度还是比较理想的

弃我去者,昨日之日不可留,乱我心者,今日之日多烦忧

Comments
Write a Comment