简中求效：Markdown 遇上 LaTeX - 少数派 - 程序猿·D·安宇雨 DeepMind

简中求效：Markdown 遇上 LaTeX - 少数派

安宇雨 - 随手采集
2023-05-23 14:48:13
随手采集
0000-未整理-等待研究

前言

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

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

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

MWeb

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

预览的公式字体太难看，不知道为什么作者不设置为科学期刊上最为常用的 Latin Modern Math 字体。我在作者的 GitHub 下发过一个 issue，他也没能给我一个有效的答复。
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 就可以预览文档里的公式了！

原文链接：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 的编译效率也十分高了。

遗憾的是，这个 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}

其中\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 文件里修改模板位置。