VS Code 使用markdown和GIT

起由

和同事一块儿把如今的产品从新梳理一下，写一份完整、规范、清晰的PRD文档。
最终定下来的方式：

• 最终选定使用markdown格式来写
• 使用GIT来同步，他找到一个可建立私有仓库的GIT（bitbucket）
• 成品作一个WIKI网站。先后试用过mediawiki/pmwiki/gitbook/dokuwiki，最终暂定使用dokuwiki

试用markdown客户端

Mac端有一些受欢迎的客户端，惋惜都不是跨平台的。因此在PC端要慢慢找，我又有如下这些要求：

• 外观最好美观
• 支持的格式不用太多，可是也尽可能不要仅支持原生markdown
• 用起来方便的
• 最好能直接导出PDF
• 有文件夹管理最好，整套文件管理次之
• 必定要客户端，而不是见面版
• 免费版最佳

把市面上推荐能用的markdown基本上都试用了一遍，最终没有一个完美的程序，可是有几个可选项：

• haroopad，是一个韩国的开源程序，界面和易用性都不错，能够直接导出PDF（最开始没发现怎么导出。可是导出发现并非很是好，基本和导出html再用chrome转成PDF是同样的效果，有些格式转不过去），有多种编辑模式（用这个软件，我学会了vim的基本操做方法），语法够用，不过还有一些简单的私有语法，因此和其余同事合做的时候会有点麻烦，很是惋惜的是没有文件管理方案，略不方便。
• CuteMarkEd，也是一款开源软件，界面稍简陋，语法支持比haroopad稍差，能导出PDF，可是导出的样式有点惨不忍睹，不过胜在有文件管理（犹豫再三，我再是把他卸载掉了）
• Cmd Markdown/马克飞象/StackEdit/小书匠，这些本质上都是网页版，不过有些是有客户端的，而后有不一样程度的收费项。不过在功能和美观度上是最领我满意的，惋惜网页版感受效率上差点事，并且文件管理甚至简单的打开文件也不是很方便。
• VS Code，关于VS Code的称赞有不少，用它来写markdown也提供了即时预览功能，预览的样式其实也能够自定义，不过支持的语法并非不少是一大遗憾。最后一点，VS Code支持GIT，目前咱们的文档并非很复杂，只用基本的markdown语法也能知足，再加上GIT功能，一个VS Code就能够知足我了，因此仍是不错的

VS Code配置

• VS Code虽说安上就能用，可是原生的markdown并非很好看，能够修改默认的markdown.css文件，调整成本身喜欢的样式。固然目前我尚未调好，搞来搞去一团糟。
• GIT配置，其实也简单，不过有几个注意点

1. VS Code时提供的下载连接是v2.7.0，可是在安装的时候win10系统会拦截，要记住这时候也是能够安装的，只要点左下角的“自定义”仍是什么按钮就能够了
2. 安装好以后，虽然我重启了VS Code，甚至重启了电脑，本身新建文件夹而且用GIT客户端同步了几遍，可是在VS Code里就是不能用，没打开文件夹的时候提示there is no currently opened folder，打开文件夹以后提示it looks like git is not installed on your system，最后才发现是要配置PATH，把GIT/cmd路径添加到环境变量里。