Sublime + MarkDown + LaTeX 环境配置（

- 简介

• 工具集合
  • 软件
  • ST插件
• 下载
  • Sublime Text 3
  • BasicTeX
  • Skim
  • Package Control
• 配置
  • TeX Live Manager
  • LaTeXTools 中文环境
  • OmniMarkupPreviewer
• 插件
  • 插件安装方法
  • MarkdownEditing
  • MarkdownPreview
  • Markdown Extended + Monokai Extends
  • OmniMarkupPreviwer
  • TableEditor
  • Markdown TOC
  • Pandoc
  • Color Sublime
  • 其他选择
• Bug解决
  • OmniMarkupPreviewer 404
  • 在MarkDown下不能改变主题的问题
• 参考
  • LaTeX部分
  • MarkDown部分

简介

为了做省赛的模板准备研究一下LaTeX，而mac上配置LaTeX远没有Ubuntu上这么方便。
仔细百度了一下，发现还是要用Sublime Text来写LaTeX比较好。
因为准备把LaTeX作为正式文章的排版工具，所以写作工具干脆就直接换成ST好了，而且Vim上MarkDown的体验也并不太好。
下载了ST之后才发现确实挺好看的。如果没有iTerm2的话，Vim的颜值远远比不上ST的GUI，而且也有不小的插件社区，对MD和LaTex的支持也好很多。
配置倒是花了我很不少的力气。

工具集合

软件

Sublime Text 3、BasicTeX、Skim、Package Control

ST插件

LaTeXTools、MarkDown Editing、MarkDownPreview、MarkDown Extended、Monokai Extends、OmniMarkupPreviwer、TableEditor、MarkDown TOC

下载

Sublime Text 3

Sublime Text
下载之后直接拖进Application就好。

BasicTeX

MacTeX
MacTeX有本体(2.4G/4G+)和Basic(101M/300M+)两种，为了节省空间，我选了BasicTeX。
本体中包含了TeXShop、TeX Live Utillty等一些工具。
比较好的是，BasicTeX中包含了TeX Live Manager，可以在shell中下载一些需要的包。
下载pkg之后直接安装即可。

Skim

Skim是一个PDF阅读器，可以用brew安装。

brew install Caskroom/cask/skim

安装完成之后需要在Preference中设置一下同步，改为Sublime Text即可。

Package Control

Package Control
这个网站上分别针对ST2/3给出了安装命令，复制，用control+`，打开Console粘贴即可。

配置

TeX Live Manager

sudo tlmgr update --self
sudo tlmgr install latexmk

LaTeXTools 中文环境

在ST中找到Browser Package，打开LaTeXTools.sublime-settings，也就是LaTeX的用户配置，在builder-setting中添加两项配置：

"program" : "xelatex",
"command" : ["latexmk", "-cd", "-e", "$pdflatex = 'xelatex -interaction=nonstopmode -synctex=1 %S %O'", "-f", "-pdf"],

LaTex默认调用Skim来打开生成的PDF文件，也可以改成macOS自带的预览。
直接在用户设置中添加："viewer": "preview"。

OmniMarkupPreviewer

在默认设置中将mathjax_enabled设置为true，之后MathJax会在后台自动下载。
这样，之后就可以在MarkDown中添加LaTeX文本，用OmniMarkupPreviewer编译即可。

插件

插件安装方法

在ST中使用Command + Shift + P打开命令。
输入install，选中Install Package。
然后就可以找自己想要的插件安装了。

MarkdownEditing

支持Markdown语法高亮；支持Github Favored Markdown语法；自带3个主题。
注：不要在打开一个md文件时安装，否则会出错。

MarkdownPreview

按Command + B会在当前目录生成HTML文件。
在文档中添加[TOC]会自动生成标题。
可以在Key Bindings中添加HotKey：

{"keys": ["alt+m"], "command": "markdown_preview", "args": { "target": "browser"}}

Markdown Extended + Monokai Extends

不错的Markdown主题，支持对多种语言的高亮。

OmniMarkupPreviwer

实时在浏览器中预览。如果双屏的话，应该具有不错的体验。
HotKey：

• Command + Alt + O: Preview Markup in Browser.Color
• Command + Alt + X: Export Markup as HTML.
• Command + Alt + C: Copy Markup as HTML.

TableEditor

Markdown中的表格书写体验真心不咋样，所有有人为这个开发了一个插件，具有较好的自适应性，会自动对齐，强迫症患者喜欢。
首先需要用command + Shift + P打开这个功能。

Markdown TOC

编辑md文件的时候可以查看自动生成，并且可以控制生产目录的层次，不过不会自动跳转。
编辑的时候可以看看，如果需要生成的HTML具有超链接跳转的功能，还是用MarkdownPreview吧。

Pandoc

可以将md文件转为PDF。
如果不包含中文可以直接转：

pandoc infile.md -o outfile.pdf

包含中文则要先编码为UTF-8，然后通过xelatex来编译：

pandoc infile.md -o outfile.pdf --latex-engine=xelatex

Color Sublime

这是一个ST的主题集成插件，基本包揽了所有的ST主题。

其他选择

如果觉得修改设置很复杂，可以在每篇文档前添加：

%!TEX program = xelatex

这会强制使用xelatex，也是解决中文问题的一个办法。

Bug解决

OmniMarkupPreviewer 404

打开OmniMarkupPreviewer的用户设置。
去除extensions中的strikeout，修改如下：

{
    "renderer_options-MarkdownRenderer": {
        "extensions": ["tables", "fenced_code", "codehilite"]
    }
}

在MarkDown下不能改变主题的问题

是MarkdownEditing的Bug。
只要改变一下其Markdown GFM的用户设置：

{
    "color_scheme": "Packages/MarkdownEditing/MarkdownEditor-Dark.tmTheme",
    "line_numbers": true, 
}

参考

LaTeX部分

• 部署MAC上的Sublime Text+LaTex中文环境
• 在Mac OS X下搭建Latex编辑环境
• Mac上使用Sublime Text＋Skim编译LaTeX
• Sublime Text 3 + LaTeX - OS X

MarkDown部分

• Sublime插件：Markdown篇
• 介绍Sublime3下两款Markdown插件
• 使用Markdown的时插入LaTeX公式
• OmniMarkupPreviewer 404解决办法