惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

雷峰网
雷峰网
MyScale Blog
MyScale Blog
PCI Perspectives
PCI Perspectives
S
Securelist
Threat Intelligence Blog | Flashpoint
Threat Intelligence Blog | Flashpoint
V
Vulnerabilities – Threatpost
C
CXSECURITY Database RSS Feed - CXSecurity.com
D
Darknet – Hacking Tools, Hacker News & Cyber Security
L
Lohrmann on Cybersecurity
C
Cybersecurity and Infrastructure Security Agency CISA
Spread Privacy
Spread Privacy
量子位
P
Proofpoint News Feed
T
Tailwind CSS Blog
腾讯CDC
G
Google Developers Blog
V
Visual Studio Blog
The GitHub Blog
The GitHub Blog
博客园 - 司徒正美
GbyAI
GbyAI
The Register - Security
The Register - Security
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
罗磊的独立博客
A
About on SuperTechFans
有赞技术团队
有赞技术团队
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
月光博客
月光博客
Recorded Future
Recorded Future
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
aimingoo的专栏
aimingoo的专栏
美团技术团队
Engineering at Meta
Engineering at Meta
博客园 - 【当耐特】
小众软件
小众软件
F
Fortinet All Blogs
Last Week in AI
Last Week in AI
U
Unit 42
T
The Blog of Author Tim Ferriss
B
Blog RSS Feed
云风的 BLOG
云风的 BLOG
Microsoft Azure Blog
Microsoft Azure Blog
The Cloudflare Blog
Recent Announcements
Recent Announcements
S
SegmentFault 最新的问题
D
DataBreaches.Net
Stack Overflow Blog
Stack Overflow Blog
A
Arctic Wolf
C
CERT Recently Published Vulnerability Notes
Security Latest
Security Latest
L
LINUX DO - 热门话题

少数派

派早报:Google 发布 Fitbit Air 等 - 少数派 「新人报到」確認需求,再開始 - 少数派 从 SOLO 独立开发者社区,我看到了越来越多开发者开始做自己的产品 - 少数派 我怎么管理那些"不常做,但总会忘"的生活事项 - 少数派 人形机器人量产元年,数据才是具身智能的“生死线” - 少数派 BuhoLaunchpad 高度还原 Mac 启动台:开发历程与思考 - 少数派 五年陪伴依然不舍,DIY 换壳后让罗技 MX Master 3 继续服役 - 少数派 新玩意 240|少数派的编辑们最近买了啥? - 少数派 一日一技|为什么你应该关闭 iOS 的键盘声音 - 少数派 我做了个插件和 Skills,一键提取任何网站的设计规范 Design.md - 少数派 住在三四线城市的你,该开始录播客了 - 少数派 甘南秘境,大白高国 - 少数派 AI的审美:谁让把我变成川内倫子 - 少数派 返工怎能不烦恼,打工人片单总有一部是你的「嘴替」 - 少数派 为了让「上厕所」更健康,我做了一个小工具 - 少数派 AI + Skill,能够让生成的文章去除 AI 味吗? - 少数派 新玩意|韶音OpenDots ONE 耳夹式耳机 - 少数派 《美满》| 在每一个春天的晚上相爱(362) - 少数派 新玩意|优篮子 PS01 MagSnap 磁吸支架 - 少数派 自我整合手记 | 我开始早睡了:用稳定规则,为自由托底 - 少数派 用龙虾(OpenClaw)两个多月,我最深的12个体会 - 少数派 听歌时间到,12 张你可能错过的 2025 华语乐坛好专辑 - 少数派 承诺能追吗 - 少数派 macOS 26启动台没了? 我做了个不一样的App启动器 - Keboard - 少数派 《四海为家的人》| INTJ对话INTJ(361) - 少数派 你发过的那些黑历史,是时候一次清干净了 - 少数派 新玩意:安安静静玩,越玩越专注:计客密码机 - 少数派 iPad 用户首次体验 Android 平板:vivo Pad6 Pro - 少数派 数据逻辑强 - 少数派 极北行+ | 一路向北,探访日本至北之地 | 001 - 少数派 万字剖析:千问App深度体验报告(2026) - 少数派 在2026年,如何真正防止别人抄袭你的作品 - 少数派 怎么用 50 块搭个 AI 语音助手?我踩了 3 天坑 - 少数派 YeeroAI:让 AI 对话真正成为知识管理的一部分 - 少数派 爬泰山 - 少数派 「旅图显影」 App 更新:这次,我们补上了一点「手感」 - 少数派 假期出门太折磨?我的 23 条经验帮你规划惬意旅行 - 少数派 工作流会变吗 - 少数派 Claude Opus 4.6 怎么用最省钱?我测了 5 种方案 - 少数派 GPT Image 2 让图文并茂不再稀罕 - 少数派 用户侧出发——什么是AI,我要不要学习? - 少数派 找片、转存、整理、播放一条龙!让你的付费网盘值回票价 - 少数派 欢迎试用!日课一问2.0插件 - 少数派 自己做的MDeditor,原本想购买 Typora 试了两次支付不成功,干脆自己做一个 - 少数派 vibe coding了一个 3MB 的小工具,让 ~/Downloads 彻底告别混乱 - 少数派 因为受不了 Mac 的风扇策略,我做了一个风扇控制工具 - 少数派 别只怪模型 - 少数派 Warp 终端的 AI 功能怎么用?我测了一周的体验 - 少数派 AI 写代码老是出 bug?这 5 个配置我后悔没早知道 - 少数派 「新玩意」苹果出相机可能就这样:Sigma BF + 45mm F2.8 DG Contemporary - 少数派 一个面向2030年的AI操作系统是什么样子的:浅谈cola这款有灵魂的Agent - 少数派 别只看写代码 - 少数派 每天解决10个问题,还是一口气攻坚解决400个? - 少数派 AI 交易机器人怎么搭?我用 Claude 跑了一周实盘 - 少数派 Maptoposter Online:把你爱的城市画成艺术海报 - 少数派 Function Calling 怎么用?我测了 3 个模型发现差距真大 - 少数派 Legend Talk:我做了个 AI 圆桌,让 160 位思想家围着你的问题转 - 少数派 如何找到自己的蓝方?在小县城寻找压力测试 - 少数派 语音输入与软件接口|2026年聊AI时,我们都聊些什么(上) - 少数派 混动已经卖爆,纯电又来补刀——钛7闪充版简直“不讲武德” - 少数派 本月玩什么|朋友收藏、识质存在、沙罗周期 - 少数派 为什么要每天坚持输出? - 少数派 Claude API 挂了好几个小时,你的项目有备用方案吗? - 少数派 Function Calling 没你想的复杂——我用它做了个有点用的工具 - 少数派 登录系统立即播放视频或者图片音乐的软件 - 少数派 我为什么创建 FlipHTML5 下载工具 - 少数派 残局没电?多品牌外设电量统一管理软件EasyBluetooth已支持RTSS游戏内显示以及AIDA64 - 少数派 前往通义路的路 - 少数派 太好看了,媲美Sun的个人导航页,NAS部署星云门户 - 少数派 乌黑嘴唇“一键检测”上线了 - 少数派 派早报:Claude AI 接入多个创意软件生态、FILCO 生产方接手品牌等 - 少数派 【更新】BearCLI、Claude 连接器与 MCP 服务器 - 少数派 记了上千条流水,还是看不懂财务?我做了一个让 AI 读懂账本的工作台 - 少数派 MINI R56 升级原厂 Sport 模式 - 少数派 新玩意 | 一棵柠檬树(仿真版) - 少数派 Momenta的“物理AI”野望,需迈过“含摩量”这道关 - 少数派 网页直接投屏控制手机!NAS一键部署PandaScrcpy,流畅丝滑可远程。 - 少数派 众测|邀你一同探索随身 AI 硬件入口 YoooClaw C·ONE - 少数派 2050大会:分享时间是真诚 参会记 - 少数派 iPad 赋能电影创作:国内首部宣纸手绘长片《燃比娃》的幕后故事 - 少数派 AI的审美:我用 8 个大模型给 100 张旅行照片打分 - 少数派 普通人如何破圈?去参加一个本地协会 - 少数派 把极空间的图标全换了,主题DIY全攻略打造你的专属NAS桌面 - 少数派 电子便签墙,帮你实现便签自由 - 少数派 我如何用三个 CLI 工具取代文档创建需求 - 少数派 原来真的有人可以玩一辈子 - 少数派 社区速递 139 | 派友热议三月买了啥、复古单反尼康 Df 体验 - 少数派 06 作品的赏析与评价 - 少数派 TDS REVIEW|索尼 WF-1000XM6 降噪真无线耳机体验 - 少数派 35.98万起售的第二代腾势D9,我看重的不是堆料,而是不凑合 - 少数派 鼠须管 Squirrel 皮肤配置指北 - 少数派 从watch ultra2换到redmi watch6 - 少数派 派早报:阿里巴巴发布视频生成模型 HappyHorse 1.0 等 - 少数派 别迷信1M - 少数派 家人们天塌了!网盘“大封杀”,多个渠道多条路,NAS部署PanHub - 少数派 AI与人勾心斗角!NAS一键部署AI狼人杀,假日休闲必备。 - 少数派 电商必备!Comfyui工作流批量生图插件,一次生成12张!支持Nano banana pro模型 - 少数派 Comfyui工作流配置Gpt-image-2模型教程,0.03/张 - 少数派 OpenClaw第三方APi怎么配置?可使用Gpt-image-2模型 - 少数派 会员社区话题精选 Ep. 103 - 少数派
苦恼
2018-03-01 · via 少数派

本文用简明的样例,介绍如何使用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文件显示如下。

左侧是Markdown源代码,对应的预览效果在右侧显示。

这里我们只包含了最简单的文本和图片。图片在我们刚刚下载文件夹的/assets子目录中。

到终端下,采用cd命令进入咱们的演示文件夹(我的在~/Downloads/demo-scholar-markdown-docx-master),执行:

pandoc demo.md -o demo.docx

可以看到,当前文件夹下,生成了demo.docx文件。

打开Word文件,内容是这样的:

基础版本的格式转换,就是这么简单。下面我们就要添加一些内容,让文稿变得愈加有学术色彩。

数学公式

我们尝试插入数学公式。

在Markdown下,可以直接使用LaTeX数学公式。你只需要负责键入符号,Pandoc负责将其转换成漂亮的公式显示在Word中。

如果你对LaTeX数学公式的输入不是很熟悉,不要紧,这里有个小抄(cheatsheet),你可以参考。

我们打开demo-math.md,可以看到这次除了刚刚的内容,还增加了一个新的部分,叫做“数学公式”。

内含一个经典物理学公式,还有相应的变量解释。

在右侧预览区里面,我们看到了公式预览的效果。

回到终端下执行:

pandoc demo-math.md -o demo-math.docx

这次生成的docx文件如下图所示:

转换后的word文件里,不论是独立公式,还是行内数学符号,都显示正常。

脚注

写学术论文的时候,经常需要加入脚注。例如在首页需要添加作者和基金支持信息之类。咱们也尝试在本部分加入对应内容。

打开demo-footnote.md,对比一下添加了哪些信息。

脚注用[^1]来表示。内容用同样的符号,后接冒号,然后填写具体信息。

这次的预览中,我们看到了脚注的标注,但是脚注内容哪儿去了?

别担心,拖拽右侧的预览窗口,我们就能看到脚注了。

但是转换成word后,这脚注还在第一页吗?

我们到终端下,执行pandoc命令:

pandoc demo-footnote.md -o demo-footnote.docx

脚注如同我们需要的那样,显示在了首页底部。本部分测试成功。

文献引用

下面我们进入关键阶段——文献引用了。

我们打开百度学术,找几篇跟大数据特性相关的文献。

键入检索主题词“大数据+3V+5V”,搜索后的结果如下:

点开第一篇,我们看看内容。

页面下方有全文链接,我们选择知网。

点击PDF下载,查看全文。其中包含以下内容,跟咱们这篇文稿的主题相关。

我们决定引用这篇参考文献。

回到百度学术的页面,点击引用按钮。

在弹出页面中,点击下方蓝色的“BibTex”。

如上图所示,该文献的Bibtex信息就是这样的一段文本。我们将其拷贝下来,存储到.bib文件里。

依此类推,我们再下载其他两份文献的Bibtex信息。

你可以打开演示目录内的myref.bib文件查看,内容如下图所示:

下面我们就要引用这些文献了。

打开demo-citation.md。

引用的时候,我们使用Bibtex中每条文献信息大括号内的第一个字段,前面加上@符号,用方括号扩起来。需要引用多条文献的时候,在方括号内,对不同文献标记用分号区隔。

我们很容易就发现,参考文献的预览信息是不正确的。

下面我们看看Pandoc能否帮助我们将其转换成为正确的Word内容。

注意这次需要使用的参数比较多。因为我们不光需要指定参考文献的格式,还得告诉Pandoc,参考文献数据存储在了哪里(myref.bib)。

pandoc --filter pandoc-citeproc --bibliography=myref.bib --csl=chinese-gb7714-2005-numeric.csl demo-citation.md -o demo-citation.docx

打开转换后的word,看看效果。

Pandoc正确地帮我们把文献的引用标记信息转换成为了上角标,根据出现的顺序自动编排序号。对于多个文献的引用情况,也做了对应的处理。

参考文献列表呢?

我们翻动页面到文末。

参考文献列表已经根据GB/T 7714-2015的规范自动生成。

将来无论是对文献引用作增删、移动、修改,都可以通过执行上面的一条命令自动更新。非常方便。

图片引用

写作长篇学术论文(例如毕业论文)时,图片可能会有很多。引用起来如果手动编号,将来插入新的图片,就得手动重排许多后续内容,很麻烦。

下面我们尝试在Markdown里插入图片标题,并且在文中作交叉引用。

请打开demo-figref.md,内容如下:

注意这里图片使用时,加入了一些新的信息。前面的方括号里面,加上了图标题;后面的大括号,使用#fig:id的方式,加入了图的标记。

引用的时候,采用{@fig:id}的方式,分别引用每个图形。

注意右侧的预览区,图标记都是原封不动显示的。

为了能够让图片引用的时候使用“图”,而不是“Figure”,我们在文件首部插入4行内容:

---
fignos-cleveref: On
fignos-plus-name: 图

预览中,这部分也出现在了文章首部,很难看。

我们执行以下的pandoc命令,注意此次加入了图片引用处理要求。

pandoc --filter pandoc-fignos --filter pandoc-citeproc --bibliography=myref.bib --csl=chinese-gb7714-2005-numeric.csl demo-figref.md -o demo-figref.docx

这次生成的Word里面,图片自动加上了编号。

第二张图,序号也符合我们的预期。

注意,目前这个图片自动编号的功能对于中文支持还有些问题。例如标题中依然显示为“Figure”,而非我们想要的“图”。不过我们只需要调整替换图标题即可,所有的引用都是正常的。

如果你的学术论文里面有数十或上百张图片,你会立即体会到这种引用方式的好处。

小结

本文我们用一个最小化的样例,介绍了如何在学术论文写作时,利用Markdown和Pandoc处理以下格式信息:

  • 数学公式;
  • 脚注;
  • 文献引用;
  • 图片引用。

此时再来看我们生成的Word文稿,已经变成了这个样子:

是不是很有成就感呢?

举一反三,你也可以把这些技巧和方法应用于其他学术文稿的写作中,它们包括而不限于开题报告、结项报告,甚至是科研项目申请书。

希望这些展示,能对你写作学术文稿效率的提升,起到促进作用。

讨论

你平时经常写学术论文吗?用的是什么工具?效率如何?除了本文介绍的方法外,有没有更好的工具和流程推荐给大家?欢迎留言,分享你的思考和经验,我们一起交流讨论。

如果你对我的文章感兴趣,欢迎点赞,并且关注我的专栏,以便收到后续作品更新通知。

如果本文可能对你身边的亲友有帮助,也欢迎你把本文通过微博或朋友圈分享给他们。让他们一起参与到我们的讨论中来。本文用简明的样例,介绍如何使用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文件显示如下。

左侧是Markdown源代码,对应的预览效果在右侧显示。

这里我们只包含了最简单的文本和图片。图片在我们刚刚下载文件夹的/assets子目录中。

到终端下,采用cd命令进入咱们的演示文件夹(我的在~/Downloads/demo-scholar-markdown-docx-master),执行:

pandoc demo.md -o demo.docx

可以看到,当前文件夹下,生成了demo.docx文件。

打开Word文件,内容是这样的:

基础版本的格式转换,就是这么简单。下面我们就要添加一些内容,让文稿变得愈加有学术色彩。

数学公式

我们尝试插入数学公式。

在Markdown下,可以直接使用LaTeX数学公式。你只需要负责键入符号,Pandoc负责将其转换成漂亮的公式显示在Word中。

如果你对LaTeX数学公式的输入不是很熟悉,不要紧,这里有个小抄(cheatsheet),你可以参考。

我们打开demo-math.md,可以看到这次除了刚刚的内容,还增加了一个新的部分,叫做“数学公式”。

内含一个经典物理学公式,还有相应的变量解释。

在右侧预览区里面,我们看到了公式预览的效果。

回到终端下执行:

pandoc demo-math.md -o demo-math.docx

这次生成的docx文件如下图所示:

转换后的word文件里,不论是独立公式,还是行内数学符号,都显示正常。

脚注

写学术论文的时候,经常需要加入脚注。例如在首页需要添加作者和基金支持信息之类。咱们也尝试在本部分加入对应内容。

打开demo-footnote.md,对比一下添加了哪些信息。

脚注用[^1]来表示。内容用同样的符号,后接冒号,然后填写具体信息。

这次的预览中,我们看到了脚注的标注,但是脚注内容哪儿去了?

别担心,拖拽右侧的预览窗口,我们就能看到脚注了。

但是转换成word后,这脚注还在第一页吗?

我们到终端下,执行pandoc命令:

pandoc demo-footnote.md -o demo-footnote.docx

脚注如同我们需要的那样,显示在了首页底部。本部分测试成功。

文献引用

下面我们进入关键阶段——文献引用了。

我们打开百度学术,找几篇跟大数据特性相关的文献。

键入检索主题词“大数据+3V+5V”,搜索后的结果如下:

点开第一篇,我们看看内容。

页面下方有全文链接,我们选择知网。

点击PDF下载,查看全文。其中包含以下内容,跟咱们这篇文稿的主题相关。

我们决定引用这篇参考文献。

回到百度学术的页面,点击引用按钮。

在弹出页面中,点击下方蓝色的“BibTex”。

如上图所示,该文献的Bibtex信息就是这样的一段文本。我们将其拷贝下来,存储到.bib文件里。

依此类推,我们再下载其他两份文献的Bibtex信息。

你可以打开演示目录内的myref.bib文件查看,内容如下图所示:

下面我们就要引用这些文献了。

打开demo-citation.md。

引用的时候,我们使用Bibtex中每条文献信息大括号内的第一个字段,前面加上@符号,用方括号扩起来。需要引用多条文献的时候,在方括号内,对不同文献标记用分号区隔。

我们很容易就发现,参考文献的预览信息是不正确的。

下面我们看看Pandoc能否帮助我们将其转换成为正确的Word内容。

注意这次需要使用的参数比较多。因为我们不光需要指定参考文献的格式,还得告诉Pandoc,参考文献数据存储在了哪里(myref.bib)。

pandoc --filter pandoc-citeproc --bibliography=myref.bib --csl=chinese-gb7714-2005-numeric.csl demo-citation.md -o demo-citation.docx

打开转换后的word,看看效果。

Pandoc正确地帮我们把文献的引用标记信息转换成为了上角标,根据出现的顺序自动编排序号。对于多个文献的引用情况,也做了对应的处理。

参考文献列表呢?

我们翻动页面到文末。

参考文献列表已经根据GB/T 7714-2015的规范自动生成。

将来无论是对文献引用作增删、移动、修改,都可以通过执行上面的一条命令自动更新。非常方便。

图片引用

写作长篇学术论文(例如毕业论文)时,图片可能会有很多。引用起来如果手动编号,将来插入新的图片,就得手动重排许多后续内容,很麻烦。

下面我们尝试在Markdown里插入图片标题,并且在文中作交叉引用。

请打开demo-figref.md,内容如下:

注意这里图片使用时,加入了一些新的信息。前面的方括号里面,加上了图标题;后面的大括号,使用#fig:id的方式,加入了图的标记。

引用的时候,采用{@fig:id}的方式,分别引用每个图形。

注意右侧的预览区,图标记都是原封不动显示的。

为了能够让图片引用的时候使用“图”,而不是“Figure”,我们在文件首部插入4行内容:

---
fignos-cleveref: On
fignos-plus-name: 图

预览中,这部分也出现在了文章首部,很难看。

我们执行以下的pandoc命令,注意此次加入了图片引用处理要求。

pandoc --filter pandoc-fignos --filter pandoc-citeproc --bibliography=myref.bib --csl=chinese-gb7714-2005-numeric.csl demo-figref.md -o demo-figref.docx

这次生成的Word里面,图片自动加上了编号。

第二张图,序号也符合我们的预期。

注意,目前这个图片自动编号的功能对于中文支持还有些问题。例如标题中依然显示为“Figure”,而非我们想要的“图”。不过我们只需要调整替换图标题即可,所有的引用都是正常的。

如果你的学术论文里面有数十或上百张图片,你会立即体会到这种引用方式的好处。

小结

本文我们用一个最小化的样例,介绍了如何在学术论文写作时,利用Markdown和Pandoc处理以下格式信息:

  • 数学公式;
  • 脚注;
  • 文献引用;
  • 图片引用。

此时再来看我们生成的Word文稿,已经变成了这个样子:

是不是很有成就感呢?

举一反三,你也可以把这些技巧和方法应用于其他学术文稿的写作中,它们包括而不限于开题报告、结项报告,甚至是科研项目申请书。

希望这些展示,能对你写作学术文稿效率的提升,起到促进作用。

讨论

你平时经常写学术论文吗?用的是什么工具?效率如何?除了本文介绍的方法外,有没有更好的工具和流程推荐给大家?欢迎留言,分享你的思考和经验,我们一起交流讨论。

如果你对我的文章感兴趣,欢迎点赞,并且关注我的专栏,以便收到后续作品更新通知。

如果本文可能对你身边的亲友有帮助,也欢迎你把本文通过微博或朋友圈分享给他们。让他们一起参与到我们的讨论中来。