用VS Code打造最佳Markdown编辑器

太过爱你忘了你带给我的痛 2022-06-13 11:24 473阅读 0赞

> 原文出处：[http://www.jianshu.com/p/18876655b452][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就可以了，先来一个我现在的界面图：

![这里写图片描述][SouthEast]

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

## Markdown Yellow主题 ##

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

![这里写图片描述][SouthEast 1]

我已经安装了，所以显示的是一个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的合并字体，中西文都有很好的显示效果。

![这里写图片描述][SouthEast 2]

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

## 配置预览风格 ##

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`替换成你自己系统中安装的合适字体名称即可。  
好了，大功告成，再回顾一下最终效果。

![这里写图片描述][SouthEast 3]

[http_www.jianshu.com_p_18876655b452]: http://www.jianshu.com/p/18876655b452
[SouthEast]: /images/20220613/7cac811e10044dada2a1876e0d285940.png
[SouthEast 1]: /images/20220613/3b4ec333a17848708c647c6b3cf2de22.png
[SouthEast 2]: /images/20220613/ff5b816c6c284d13b95f232913c8880b.png
[SouthEast 3]: /images/20220613/9573e6d4e495483a8e6377a641237abf.png