沙滩星空的博客沙滩星空的博客

支持Markdown的开源文档工具或WIKI系统整理

引言

文档或者WIKI系统,现在流行直接用MarkDown创作。毕竟MarkDown语法,几分钟就能学会。
总有一堆人,他们认为,产品手册,以后是要打印的,所以,还是MS Word好。他们认为,MarkDown对于运营与产品的人来说,他们不懂。他们认为,MediaWiki是行业老大。MediaWiki是行业老大也是快20年前的事了。并且,你要学会MediaWiki的语法,比学会MarkdDown还难。

本来三天能干完的,结果9到15天不一定能完。也许,有钱就可以任性。理由还很充分,需要Word格式,需要PDF格式,却不知,HTML转WROD有多方便,转PDF又有多方便。而反过来呢,你即使把Word存为HTML,它也不是文档模式的网站。

这边介绍的都是轻量级工具,太大规模的企业可能不合适

单产品文档

如果做单个产品文档,最好的选择是docify。这个微型的JS开源,几乎做到的业内第一,当然,让大家喜欢的是,要你只敲键盘就能把文档完成,因为,用的是MarkDown。

WIKI或文档仓库

如果你想把一堆文档弄在一起,或者做企业内问的WIKI,也不需要那么复杂。说说我喜欢的几个开源。
SmartWiki,这个名为wiki的,实际就是一个MardDown文档系统。基于PHP,LARAVEL,不过,现在此项目停止更新了。因为有一个用GO重写的这个项目,叫 MinDoc

另一个则是,BookStack。基于PHP,LARAVEL,书栈网就是这个程序。

这两个,都可以创建不同的项目,每一个项目可以是一个产品的文档。相当好用。

总结

  • docify
  • MinDoc
  • BookStack

文档或者WIKI系统,你用什么开源组件? https://juejin.cn/post/6960689702609518629

未经允许不得转载:沙滩星空的博客 » 支持Markdown的开源文档工具或WIKI系统整理

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址