本文用简明的样例,介绍如何使用Markdown和自动化工具帮你处理数学公式、参考文献引用、图片交叉索引等学术论文写作中常见的棘手问题。快来试试吧。
苦恼
自从我学会了如何在数字文档上用红笔写写画画,跟学生合写文章和指导毕业论文的工作就变得轻松多了。
有的部分,学生会很快改完反馈给我。但是我发现每次对引言和文献综述部分做出调整要求,学生们的反馈都非常慢。
有的时候,学生甚至会求饶,“老师,参考文献顺序能不能不动?或者全文都确定下来再统一做?每次调整一个,就需要很长时间!”
我一时惊愕,为什么需要那么久?
后来才明白,他们居然是在word中一条条手动插入尾注,来引用参考文献的。尾注的内容有的直接搬过来,有的手动输入,结果参考文献列表的格式“丰富多彩”——有的信息不全,有的格式根本就不符合GB/T 7714-2015的规范。
在我的帮助下,许多学生学会了使用NoteExpress, Endnote, Zotero和Mendeley等工具,用自动化方式管理和引用参考文献。
但即便是这样,效率依然不够高。尤其是跟别人协作的时候,参考文献引用的修改就成了噩梦。
你可能需要每次都把Mendeley或者Zotero的文献库同步给对方,否则自动生成的引用标记就容易乱掉。
写作学术论文时,你还不得不时常面对图表交叉引用、数学公式和脚注等问题。如果方法不当,会把宝贵的时间和注意力耗散掉,劳而无功。
Word编辑器用来写学术论文,可能真的并不是最优方案。
但是没办法,国内学术界,尤其是人文社科领域,目前投稿模板还主要是Word的。
好消息是,即便是形成Word文稿,效率也是可挖掘的。
我平时写作学术论文的时候,用的依然是让人喜欢的标记语言——Markdown。对,你没听错,它不光可以帮你写公众号、做幻灯,也可以写论文哦。
通过本文,我把自己用Markdown写作学术论文的流程分享给你。希望看过之后,能帮助你提升效率,带来更多愉悦的写作体验。
方案
我的方案,是采用Markdown来写作内容。然后用文档格式处理界的瑞士军刀Pandoc,把内容转换成Word格式。
Pandoc实在是黑科技。我曾经用它给你演示了如何把思维导图秒变成幻灯。还记得其中这张图吗?
图中每一个节点,都是Pandoc支持的一种文档格式。Markdown, Docx, PDF, LaTeX, ePub, HTML …… 基本上涵盖了我们常见的发布格式需求。
一次写作,多种格式发布。听起来是不是很兴奋呢?
要使用这一方案,我们需要安装一些必要的工具。这就开始吧。
环境
我们需要安装以下几样东西:
Python 运行环境;
Pandoc;
Atom编辑器;
样例文件夹。
下面我们一一介绍安装方法和注意事项。
Python环境
我们的演示中,需要用到pip等Python环境工具。最简便的方法是安装Anaconda套装,这样就不必对各种组件一一手动调整安装了。
请到这个网址 下载最新版的Anaconda。下拉页面,找到下载位置。根据你目前使用的系统,网站会自动推荐给你适合的版本下载。我使用的是macOS,下载文件格式为pkg。
下载页面区左侧是Python 3.6版,右侧是2.7版。请选择2.7版本。
双击下载后的pkg文件,根据中文提示一步步安装即可。
Pandoc
请到这个网址下载Pandoc。
根据你的操作系统,下载对应的版本。我在macOS下,需要下载其中的pkg扩展名安装包,双击安装。
为了处理图形的交叉引用,我们需要添加一个pandoc插件。
在终端(macOS, Linux)或者命令行(Windows)下,执行:
pip install pandoc-fignos
正常安装后,pandoc就算准备好了。
Atom编辑器
请到这个地址下载Atom编辑器。网站会根据你的操作系统,自动找到对应的版本供你下载。
因为我用的是macOS,所以这里网站提供的是苹果版本Atom。
下载之后,安装运行。然后你需要安装1个插件,帮你预览Markdown,叫做markdown-preview-enhanced。
安装方法如下:
使用Cmd + ,呼叫配置菜单。注意我这里说的是苹果系统macOS上的操作。如果你用的是Windows,请把所有出现的Cmd按键替换为Ctrl按键,或者查阅帮助文档。
选择左侧边栏的最后一项+号,用于安装新的插件。
在搜索框中输入该插件的名字:markdown-preview-enhanced,点击搜索结果中该插件的Install按钮。
很快,插件安装好了。
这样,我们就可以实时查看Markdown的预览效果了。
样例文件夹
我专门为这篇教程,准备了一个github项目。
请从这个位置,下载压缩包,之后解压。
把其中的demo.md文件拖动到Atom编辑器中,就可以正式开始我们的探索之旅了。
基础版本
Atom编辑器里,demo.md文件显示如下。