如何用markdown写文档,并保存到git
markdown是工程师最喜欢的文档语言 ,简洁而灵活;而git版本管理又是工程师的另一最爱。如果能用markdown写文档,并托管保存到git,那将会是件很愉快的事啊。
walden号称“可能是最适合东半球同学使用的文档框架”,是一款更适合工程师的文档框架。官方主页:http://www.huamanshu.com/walden.html,Demo地址:http://walden.huamanshu.com/
支持中文目录层级,和中文文档名字,想想gitlab既不支持wiki层级,更不支持中文的痛吧。
支持图片、附件上传,并生成url。而这些文档、图片、附件都会保存到git中,文档搬家直接clone你的git地址就行。
操作方法
- 01
git clone git@github.com:meolu/walden.git 检出代码
- 02
vi Config.php 配置中的git地址 return [ // 保存文档和附件的git ssh地址,可以是在github,好吧,不想公开,可以bitbucket ///php进程的用户的id_rsa.pub已添加到git的ssh-key。这样才可以推送markdown下的文件。 'git' => 'git@github.com:meolu/Walden-markdown-demo.git', ];
- 03
刷新页面,优美的预览页面
- 04
清爽的编辑界面,引爆写作灵感
- 05
人性化的操作
赞 (0)