用VS Code打造最佳Markdown编辑器

原文出处：http://www.jianshu.com/p/18876655b452

为什么选择VS Code？

在选择Visual Studio Code（以下简称Code）作为markdown主力编辑器之前，我在Mac电脑上尝试了简友们推荐的各种编辑器，有Ulysses、Sublime Text、Atom、Vim、Mou……，不得不承认这些编辑器都很优秀，漂亮，强大，但是最后我还是选择了Code，因为我发现它不仅有完备的功能还有其他编辑器所不具有的优点：

不会像Ulysses那样自作主张，把我文档里面的``更改为\“，害得我代码块不能正常显示；
Sublime和Atom的Preview和Edit需要安装不同的插件，Code下载之后就支持语法显示和预览，不需要任何配置就可以开工；
Mou很好，所见即所得，但是运行慢，打开大文件很卡，正式版也不知道要等到啥时候；
Marxico功能强大，可是需要连接Evernote来用，我都没办法打开一个本地文件夹……；
Vim是我使用多年的编辑器，本打算装一个vim-markdown插件之后就用它了，但是预览功能还要靠外部浏览器，再加上Vim只支持等宽字体，写代码还行，写文章就有点力不从心；

简单设置

虽然Code不用怎么配置就可以很好地工作，但你要是肯花一点时间，可以达到更好的效果。一般来说，安装一个主题，选择一个Markdown预览的CSS就可以了，先来一个我现在的界面图：

默认的深色背景适合写代码，不适合写大片文本，所以安装了一个Markdown Yellow的主题，默认的字体也是等宽字体，我改成了Apple上最潮的苹方字体，还有就是预览的默认字体是英文字体，我自定义了一个用中文字体的css文档，下面将几个步骤详细说一下。

Markdown Yellow主题

Code安装插件的快捷键和Sublime、Atom的都一样，是⌘+⌂+P，也可以用F1，调出快速安装命令栏之后，输入Install Extension回车，然后输入过滤字符Markdown Theme快速定位到这个插件，选择最右边的那个下载按钮安装重启即可。

我已经安装了，所以显示的是一个X，表示卸载。

配置中文字体

编辑器大部分都是方便写代码的，Mac上最经典的配置大概是12px的Menlo字体，这个写代码很适合阅读，但是不适合大块文章，所以更改默认字体是必须的，在Code中按⌘+,快捷键，调出配置文件，修改如下：

{
//-------- Editor configuration --------
// Controls the font family.
"editor.fontFamily": "PingFang SC",
"editor.fontSize": 16,
}

我比较喜欢苹方字体，所以将编辑器默认字体改成了PingFang SC，如果你的Mac系统没有更新到最新版本，可以在网上下载这个字体文件，对于Windows用户来说，可以设置成YaHei-Consolas-Hybrid，这是雅黑和Consolas的合并字体，中西文都有很好的显示效果。

使用苹方字体的编辑窗口。

配置预览风格

Code自带的Markdown预览基本够用，就是在显示汉字的时候，感觉有点别扭，还有默认风格过于简陋，对于我这个有点强迫症的人来说，还需要再次改进:-)，先打开配置文件，在里面增加一行：

"markdown.styles": [ "file:///Users/you-name/Documents/vscode-markdown.css" ],

这表示markdown预览的风格将用我自定义的vscode-markdown.css文件，记得这里需要填写file://协议，因为预览功能是基于浏览器实现的，接下来让我们创建这个css文件。

小窍门：要检查文件是否能正常工作，只要将这一行粘贴到浏览器的地址栏里面，看能否打开这个css文件即可。

@charset "utf-8";
/** * vscode-markdown.css */
h1, h2, h3, h4, h5, h6, p, blockquote { margin: 0; padding: 0;}
body { font-family: "PingFang SC", "Hiragino Sans GB", Helvetica, Arial, sans-serif; padding: 1em; margin: auto; max-width: 42em; color: #737373; background-color: white; margin: 10px 13px 10px 13px;}
table { margin: 10px 0 15px 0; border-collapse: collapse;}
td, th { border: 1px solid #ddd; padding: 3px 10px;}
th { padding: 5px 10px; }
a { color: #0069d6; }
a:hover { color: #0050a3; text-decoration: none;}
a img { border: none; }
p { margin-bottom: 9px; }
h1, h2, h3, h4, h5, h6 { color: #404040; line-height: 36px;}
h1 { margin-bottom: 18px; font-size: 30px; }
h2 { font-size: 24px; }
h3 { font-size: 18px; }
h4 { font-size: 16px; }
h5 { font-size: 14px; }
h6 { font-size: 13px; }
hr { margin: 0 0 19px; border: 0; border-bottom: 1px solid #ccc;}
blockquote{ color:#666666; margin:0; padding-left: 3em; border-left: 0.5em #EEE solid; font-family: "STKaiti", georgia, serif;}
code, pre { font-family: Monaco, Andale Mono, Courier New, monospace; font-size: 12px;}
code { background-color: #ffffe0; border: 1px solid orange; color: rgba(0, 0, 0, 0.75); padding: 1px 3px; -webkit-border-radius: 3px; -moz-border-radius: 3px; border-radius: 3px;}
pre { display: block; background-color: #f8f8f8;  border: 1px solid #2f6fab; border-radius: 3px; overflow: auto; padding: 14px; white-space: pre-wrap; word-wrap: break-word;}
pre code { background-color: inherit; border: none;  padding: 0;}
sup { font-size: 0.83em; vertical-align: super; line-height: 0;}
* { -webkit-print-color-adjust: exact;}
@media screen and (min-width: 914px) { body { width: 854px; margin: 10px auto; }
}
@media print { body, code, pre code, h1, h2, h3, h4, h5, h6 { color: black; } table, pre { page-break-inside: avoid; }
}

大部分情况下，你只需要粘贴这个内容到CSS文件中即可，我这里用的是苹方和冬青黑体，考虑到你可能更喜欢其他的字体（例如雅黑），只要将

font-family: "PingFang SC", "Hiragino Sans GB", Helvetica, Arial, sans-serif;

中的PingFang SC和Hiragino Sans GB替换成你自己系统中安装的合适字体名称即可。
好了，大功告成，再回顾一下最终效果。