image

前言

我之前在 Matrix 上分享了石墨文档的轻体验文章,提到石墨文档、有道云笔记、Leanote 之类的文档协作应用,这部分应用属于通用型的文档协作工具,惯常会支持团队协作、Markdown 语法等特性。而今天向大家推荐的 KanClould 看云有着明显不同,其更加专注技术文档这一范畴的写作领域,从代码写作编辑到技术文档托管发布,都有着更好的优化和支持。

体验报告

KanClould 看云对自己的介绍是这样的:

看云KanCloud ( http://www.kancloud.cn ) 是一个文档托管服务平台,致力于提供最佳的在线文档创作和阅读体验,让企业和个人可以更方便、更轻松的管理及分享自己的文档。

目前,看云几个主要特性包括了:文档托管和发布、支持 Markdown 语法、文档域名绑定、文档权限控制、全屏阅读模式、响应式设计的阅读方式和团队创建等等。以上这些特性,我相信不少文档写作平台都会提供很好的支持,但是下面要介绍的,应该是看云几个最能吸引我的亮点。

image

  • 丰富的文档创建类型

看云支持创建的文档类型包括了普通文档、技术文档、API 文档以及 PPT 文档。对于大部分普通用户来说,普通文档已经足够应付日常使用需求。在创建文档中,我们依然能够看到看云不少的亮点,比如支持外部导入 CHM、EPUB格式的文件,文档自动生成 Git 版本控制,文档自定义独立域名绑定,全屏编辑文档。

image

  • 代码高亮和 Git 版本控制

从上面创建文档的介面,我们可以选择创建一份技术文档,与普通文档有所不同的是,技术文档将默认支持代码高亮。Git 版本控制的特性,让看云成为吸引码农写作的又一亮点。熟悉 Git 操作的玩家,可以将整个文档镜像复制下来,进行更加灵活的本地控制写作。

image

  • API 文档写作和在线调试

支持创建 API 文档,属于看云一大利器,看云能够快速生成 API 文档,并且支持在线调试,感兴趣的用户可以阅读官方给出的「API 文档插件使用说明」。

image

  • 分享优秀的技术文档

看云广场属于大家在看云撰写文档的发布平台,官方给出的说法就是:优秀的文档会被推荐到广场或者收录到某个专题,这是帮助你的作品快速提升人气的办法,欢迎大家提交优秀的作品给我们。当然我们可以选择免费或者自定义文档价格的方式,将自己的文档或者书籍贡献在看云广场上。

在这里,想大家推荐两本不错的公开文档——全栈工程师培训材料、程序员的自我修养。

总结

我将看云定位为:偏向技术文档写作的平台,推荐给希望将自己撰写的技术文档或者教程分享出来的专业作者们,看云目前已经给出了很好的功能选项——代码高亮、Git 版本控制、多人协作。即使是希望撰写普通文档的用户来说,看云完善的文档权限控制、简单明了的编辑器介面、文档内部目录导航功能,也相当值得我们花时间体验这款2015年才出现的笔记工具。稍显不足的地方,看云免费版仅支持创建 1 个私有文档,可能并不适合专注于创作个人文档的作者(看云专业版支持 10 个私有文档)。

最后,看云当然少不了文档打赏和付费阅读的功能,码字和收获要成正比才行啊(此处应该有笑声)。

Enjoy.

1
4