fangpsh's blog

Markdown 制作幻灯片与编写文档

从使用markdown一开始,编辑器一直在换(还动手写过一个简单的实时预览编辑器。。用正则做渲染处理,效果不是很好),
从windows下的markdownpad,到linux下的retext,haroopad,以及在线的stackedit.io,dillinger.io等,后来选择使用emacs+本地监控和渲染工具(例如nodejs写的markdown server之类的),到目前选择编辑器(emacs)+pandoc,还是十分舒服和便捷的。另外mac下的大名鼎鼎mou一直没有机会使用:(

pandoc的强大就不多说了,大家有兴趣看看官网那张转换图:http://johnmacfarlane.net/pandoc/
pandoc的安装啥的也就略过了,有需要的话可以看看阳志平老师的:
Markdown写作进阶:Pandoc入门浅谈 ,里边也有一些基础的使用教程。
另外建议过一遍 pandoc的markdown的语法:Pandoc’s Markdown 语法中文翻译

制作幻灯片

基本可以参考这两篇文章:

另外需要补充两点,

  • 如果幻灯片中有代码,而需要代码高亮时,可以看看How to print Source Code with LaTeX,基本里边提到的语言大都是支持的,到时候在代码块处指明即可。
  • 如果输出为beamer的时候可能会遇到中文字体的问题,解决的方法也就是使用自定义的模板,并在其中指定中文字体了,网络上有很多不错的中文的beamer模板可以采用,也可以直接修改pandoc默认的beamer模板,这里贴一份,不知是从何处参考的,忘记了出处:https://gist.github.com/fangpsh/6822e5fc6a21f21a5a51 ,大家可以根据自己本机的情况修改其中的中文字体选项等。

编写文档

一开始选择使用pandoc转换为pdf,主要是因为它支持目录索引,在XX游戏实习那会,编写的文档超过一百页了,没有目录实在不方便,找了一圈用了pandoc,而且配合latex模板,可以做比较好的排版,(latex这种复杂的东西没毅力学,所以也是拿网友共享的模板)。

具体可以参考这两篇:

中文字体相关的问题以上两个链接中都有提到了,按照对应的流程解决即可,不过注意第二个链接中LiHei Pro好像对简体支持有问题,所以大家可以看看本机上安装的中文字体,然后选项一个合适的指定即可。这里也贴一份模板,也是直接使用一份网友的模板(出处找不到):
https://gist.github.com/fangpsh/5cc11fa503f1e9eda2c1