用VS Code打造最佳Markdown编辑器

作者: 混沌边缘的伊卡洛斯 | 来源:发表于2016-03-19 19:58 被阅读86941次

    为什么选择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 SCHiragino Sans GB替换成你自己系统中安装的合适字体名称即可。
    好了,大功告成,再回顾一下最终效果:-D

    编辑和预览界面

    下载资源

    以上所有提到的资源都可以在官方网站免费下载,也提供了百度盘链接,酌情下载:
    Visual Studio Code 0.10.11
    苹方字体
    Markdown的CSS配置文件

    要是使用中有什么问题,欢迎和我交流,谢谢~

    相关文章

      网友评论

      • 29e8b0aa682e:vscode 插件 Markdown Preview Enhanced
      • 林万程:Typora了解一下,编辑预览同窗口
        豪门百里:@林万程 我的下载速度平均不到10k每秒,且官网上的图片都浏览不出来。我家的网络算很不错的了。缘分不到,我更多地使用vscode
        林万程:@豪门百里 也就几十秒啊,有什么问题?
        豪门百里:就一个官网下载速度就足够让你放弃了。
      • 彩荷之光:怎么让vscode的markdown支持table和其它组件?
      • 白蜀黍:之前一直用 atom 最近转 vscode 的路过,不过没有找到自动格式化 markdown 的插件,不知道作者大大有没有可以推荐下的?
      • b6632d30a054:请教一下:配置预览风格这一点不太懂。请问是点哪个功能导进你提供的css文件的捏~~感谢
        b6632d30a054:找到了,原来是在首选项-编辑-选择markd-展开后拉到最底-编辑保存。。。
      • 一溪风月:我想在照片下方增加文字说明,不知道怎么输入?以前富文本的格式是直接可以输入的。谢谢
        一溪风月:@混沌边缘的伊卡洛斯 谢谢回复
        混沌边缘的伊卡洛斯:@一溪风月 要看markdown的说明,这个和编辑器没有关系的
      • d0bfeb9adf65:lz我在fontfamily那里换字体没效果,要先把字体下到电脑对吧
        混沌边缘的伊卡洛斯:@漂亮的花开不败纽约街 是的,要安装字体
      • 郝开心信札:楼主可以试下sublime下的OmniMarkupPreviewer插件,编辑和实时浏览器预览,一直在用,感觉很方便。
      • c622eefcef40:楼主问一下,vscode有语法提示或者补全功能吗,就是按某个快捷键会出现提示的那种,或者说有这种功能的插件吗
        混沌边缘的伊卡洛斯:vscode本身是代码编辑器,这种基本功能本身就是具备的
      • 静美书斋:请问简主,你安装的是哪一款Markdown插件呢?我安装的“Auto-Open Markdown Preview”插件。。。好像这款插件不能实时预览
        混沌边缘的伊卡洛斯:@静美书斋 主题是修饰,不是功能
        静美书斋:@卡里斯玛 嗯嗯,那请问简主,主题能否实现markdown的实时预览呢
        混沌边缘的伊卡洛斯:@静美书斋 预览不需要插件,我安装的是主题,不是一定要装的
      • 988ea867e318:有个问题请教下楼主,VSCode 预览的 Markdown 能够导出 HTML 文件吗?
        eba0b5453551:有插件的, copy markdown as HTML
        混沌边缘的伊卡洛斯:@Askd 我一般用pandoc来处理这种事情,那个工具的可配置参数很多,用起来也方便:smile:
        混沌边缘的伊卡洛斯: @Askd 这个没试过,我一般是用pandoc来转换格式的
      • tamlok:我也折腾过Vim写Markdown~~同样是感叹GVim作为GUI都不能显示图片~~于是自己折腾了一个VNote,欢迎交流~ [VNote](http://www.jianshu.com/p/c57bb900b322)
        kanek1:怎么实时预览
        tamlok:@卡里斯玛 Typora我也了解过,觉得在降低编辑与阅读的割裂感上矫枉过正了。Markdown作为一个纯文本的标记语言,目的就是让作者能全权掌握文档;但Typora往往强迫很多事情,另外也因为实现的复杂性,造成很多语法上的bug。还有一点是,Typora不具备笔记管理的功能。:) VNote在实现的过程中也考虑过如何降低割裂感,感觉传统的两栏预览、Typora的方式都没达到我的预期,所以就折腾了一个 :)
        混沌边缘的伊卡洛斯:@tamlok :smile:,我现在一般就用typora了
      • bb3df733dd5c:为知笔记带的那个挺好用
        tamlok:为知笔记的编辑体验实在不敢恭维~~使用HTML来保存笔记内容,所以格式各种乱~特别是Linux下粘贴文本简直是噩梦~我最近折腾了一个VNote,针对WizNote的痛点结合Vim编辑器的优秀体验进行设计,欢迎交流~ [VNote](http://www.jianshu.com/p/c57bb900b322)
      • 2eb728ca4286:你好,主要安装好后,怎么用这个主题?
        7eecdc9a482d:@否定先生_Campo 重新启动后在哪里使用主题?我是用mac系统
        2eb728ca4286:@卡里斯马 已经OK?谢谢
        混沌边缘的伊卡洛斯:@否定先生_Campo 重新启动之后在菜单中选择
      • 梅独苏:好像非常不错的样子!

      本文标题:用VS Code打造最佳Markdown编辑器

      本文链接:https://www.haomeiwen.com/subject/krbhlttx.html