前言

我是一个物理工作者,MS Word/WPS 什么的很早就扔掉了。LaTeX 才是我们的家常便饭。本科时候在课堂上我就喜欢拿着 LaTeX 编辑器做笔记,当时就盼望着哪天 Evernote 能够支持 LaTeX 语法。在 macOS 下配置 LaTeX 编译环境十分简单,只要下载一个 MacTeX,它自带 TeXShop,然后一切就都搞定了。

后来知道了 Markdown 语法,这样一个花 2 分钟就能学会的「标记语言」直接戳中我这样一个极简主义者的 G 点。与 LaTeX 最大的不同在于,它不会像大多数 LaTeX 编辑器一样在仅修改了一个标点之后,都要求重新编译。

然而要同时实现 Markdown 的极「简」,和 LaTeX 的「效」能是非常艰难的。虽然在静态博客里可以使用 MathJax 显示公式,但在 macOS 端编辑博文时没有 LaTeX 预览也是很难过的一件事。

MWeb

你可能会说 MWeb 就支持 LaTeX 的编辑和预览呀!的确,我尝试过它,但这里提出两点我后来放弃它的原因:

  1. 预览的公式字体太难看,不知道为什么作者不设置为科学期刊上最为常用的 Latin Modern Math 字体。我在作者的 GitHub 下发过一个 issue,他也没能给我一个有效的答复。
  2. MWeb 没有 iOS 版,不能多设备同步。

 

Typora

还有声名鹊起的 Typora,我觉得它单作为 Markdown+LaTeX  编辑器可谓最优选:插入公式的方式不能再漂亮、默认的主题也简单优雅。

但它不能对文档进行管理,没有所谓的「外部文件夹」。而且,它也没有 iOS 版。

 

综上,我的要求其实很苛刻——优秀的编辑环境、Markdown、LaTeX预览、多设备同步集合为一体。于是我开始在 Ulysses 和 iA Writer 上寻求出路,因为这两个软件首先就符合我对「优秀的编辑环境」的要求。最终我找到了我的解决方案。

方案一 Ulysses + HTML

Ulysses 是支持 HTML 预览的,所以我们在 Markdown 文档里插入一些 HTML 语言也没有关系。前天我就在 @ulysses 官推上看到了这个在 Ulysses 下实现公式预览的方案。

只需要在文档开头加入这四行 Raw Source Block 即可

~~ <script type="text/x-mathjax-config">
~~ MathJax.Hub.Config({tex2jax: {inlineMath:[['$','$']]}});
~~ </script>
~~ <script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>

其实这就是 HTML 下的 MathJax 相关设置。不用担心那些小波浪号,它们是 Ulysses 用来标记 Raw Source 的符号,无论是导出还是发布到你的的静态博客上都不会影响。

之后只要将正常 LaTeX 语法包裹进 Raw Source 格式中即可,比如

神奇公式:
~~ $$\left(iD\!\!\!/+m\right)\psi = 0$$
~$\dfrac{1}{2}$~,这就是二分之一,想不到吧!

然后调整 Ulysses 的导出格式为 HTML,使用 ⌘+⇧+P 就可以预览文档里的公式了!

Image

原文链接:Writing Mathematical Equations in Ulysses

方案二 iA Writer + Export Markdown to PDF(Service)

我们也可以利用 iA Writer 实现 Markdown + LaTeX。

同样是解决 LaTeX 公式预览问题,我发现了这样一个系统服务——Export Markdown to PDF。它是基于 pandoc 命令,在 iA Writer 下将文档转换为 PDF,并在默认 PDF 应用程序下预览。虽然不像 iA Writer 自带的预览那样高效,但如果只是插入几行公式,对我来说这已经最佳方案了。况且近日发布的 iA Writer 4 支持多文件、模块化编辑,对于每个子文件而言 pandoc 的编译效率也十分高了。

Image

遗憾的是,这个 Export Markdown to PDF 已多年没有维护了,它环境变量设置已经因为新版本路径更改无法使用,而且最致命的是它不支持中文文档。于是我将它 Fork 了一下,修改成为了支持中文的 LaTeX 编译服务,下面我用四步教大家如何配置它:

第一步

首先,毋庸置疑你的电脑里必须安装有 MacTeX,并且我建议安装最新的 2016 版,否则环境设置可能会略有不同,导致不必要的麻烦。

以及,转换 pdf 所需的 pandoc(在终端下用 brew install pandoc 命令安装)。

第二步

配置 xelatex 中文编译模板

mkdir ~/Templates
cd ~/Templates
pandoc -D latex > template.tex  %导出pandoc默认模板文件

然后我们在导出的默认模板文件 template.tex 上进行修改。定位到 「% if luatex or xelatex」,在下图白色箭头处( \fi 的下一行)插入如下语句:

% SUPPORT for Chinese
\usepackage[boldfont,slantfont,CJKchecksingle]{xeCJK}
\usepackage{fontspec,xltxtra,xunicode}
\defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
\punctstyle{quanjiao}
\setCJKmainfont{WenQuanYi Micro Hei}
\setCJKsansfont{KaiTi}
\setCJKmonofont{SimSun}
\defaultfontfeatures{Ligatures=TeX,Scale=MatchLowercase}

Image

其中\setCJKmainfont{WenQuanYi Micro Hei}可以自定义主字体(LaTeX 老司机也可以尝试修改其他内容),我测试时用的是「文泉驿微米黑」字体,大家可自行修改。但最好像我一样使用字体的英文名称。什么?你不知道怎么查看字体的英文名称?到终端使用下面这条命令查阅系统内的字体英文名吧。

fc-list :outline -f "%{family}\n"

第三步

下载我 Fork 的 Export Markdown to PDF,把 workflow 文件放到 ~/Library/Services 路径下

第四步

在 iA Writer 下使用:iA Writer → 服务(Services) → Export Markdown to PDF 即可。编译的时候可以看到右上菜单栏会有个旋转的小齿轮⚙️,特别可爱。如果 LaTeX 语法有错误,错误信息会以弹窗的形式出现,方便你 debug。

Screen Shot 2016-11-30 at 3.55.30 PM.png

一些说明

  • $ \dfrac{1}{2}$ 会报错,要改为$\dfrac{1}{2}$才行,好像是第一个$后面不能出现空格
  • 需要自行研究一些特殊宏包的插入,例如页边距的设置等,毕竟在 Markdown 文档里无法使用 \usepackage 命令了,有些茫然不知所措
  • 用 Automator 打开 Export Markdown to PDF.workflow 你可以看到下面这些内容:
    • pandoc 环境设置
    • xelatex 环境设置
    • pandoc 转换 pdf 的命令,其中 --template 字段设置的是 pandoc 编译模板,这就是第二步中为何要生成 ~/Templates/template.tex 文件的原因,你可以自行配置多个模板,然后记得在 workflow 文件里修改模板位置。

结语

祝大家 LaTeX 愉快!