Markdown在项目中的实践

在Markdown以前，咱们使用Word编辑项目文档，基本上只能一我的编辑文档，并且若是用多台机器也不太方便，一不当心忘记更新就会致使没法合并。Mardown无需多言，由于纯文本格式，很是适合多人编辑文档，咱们在项目中推广Markdown，把Markdown文档放在Svn中，这样完美的解决了文档的持续更新问题，无论是多人仍是多台机器编辑，都和编辑普通代码没什么区别了，文本的合并使用很成熟的方法便可。

随之而来的问题（或者说不便）是若是要看Svn中的Mardown文档，须要更新本地目录，并使用专门的软件，这有些不便。程序员还好，其余项目参与人员就更麻烦一些，但咱们又不想损失SVN管理的优势，所幸咱们在Topo项目管理软件中看到了好的解决方案。

第一步配置好Svn库：

而后在项目下，配置项目的代码库目录，多是一个分支，也能够是一个目录：

这样就能够浏览Svn中的Markdown文件了，很棒的地方在于，Mardown中引用的Svn里的图片能够正确的显示出来，这样就很是方便了：

经过这种方式，咱们把大部分项目文档转到了Markdown格式，方便项目成员随时修改和浏览。