V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
chogath
V2EX  ›  程序员

求推荐文档工具

  •  
  •   chogath · 2021-05-19 10:16:38 +08:00 · 3294 次点击
    这是一个创建于 372 天前的主题,其中的信息可能已经有所发展或是发生改变。

    需求:

    1. 用于维护文档;类比:gitbook,可以托管在 gitee 或者 github
    2. 用于维护开放内容( WIKI )
    第 1 条附言  ·  2021-05-19 14:58:15 +08:00
    ---

    最后选择用 wolai,国内受限,有些时候用不了 Notion.
    29 条回复    2021-05-21 10:02:57 +08:00
    zhengxiaowai
        1
    zhengxiaowai  
       2021-05-19 10:17:55 +08:00
    非技术人员或者喜欢简洁但是又不单调的可以试试 飞书文档
    chogath
        3
    chogath  
    OP
       2021-05-19 10:20:24 +08:00
    @zhengxiaowai 想要个开源的工具,飞书 / 钉钉 / 腾讯文档之流就算了... 谢谢
    wdssmq
        4
    wdssmq  
       2021-05-19 10:30:54 +08:00
    balabalaguguji
        5
    balabalaguguji  
       2021-05-19 10:39:07 +08:00
    推荐易文档,专门写技术文档和接口文档的,看例子:
    https://www.easydoc.xyz/doc/70593782/aVnU6s8b/g9ZxauwE
    https://www.easydoc.xyz/s/17790664/CZMqMhfW/78558034
    proger
        6
    proger  
       2021-05-19 10:39:35 +08:00
    docsify
    Ayanokouji
        7
    Ayanokouji  
       2021-05-19 11:04:25 +08:00
    语雀
    chogath
        8
    chogath  
    OP
       2021-05-19 11:12:43 +08:00
    @wdssmq
    @balabalaguguji

    现在用的就是 docsify 体验还行,备选之一

    @Ayanokouji
    好的我研究下

    @balabalaguguji
    这个感觉有点像 gitbook
    chogath
        9
    chogath  
    OP
       2021-05-19 11:13:34 +08:00
    今天看到一个东西 —— 知识盒子: https://zhishihezi.net
    感觉这个还挺有意思的,有相关开源的方案就好了。
    per
        10
    per  
       2021-05-19 11:29:52 +08:00 via iPhone
    Hackmd
    Qingquexiezuo
        11
    Qingquexiezuo  
       2021-05-19 11:44:39 +08:00
    heboy
        12
    heboy  
       2021-05-19 11:47:20 +08:00
    docp 思路还行,完成度可能不高😂
    https://cicel.github.io/docp/en/introduction.html
    HerrDu
        13
    HerrDu  
       2021-05-19 12:29:46 +08:00
    语雀,不是一般的好使
    laragh
        14
    laragh  
       2021-05-19 13:11:53 +08:00
    vuepress 也行,飞书更好可以同步不用自己搭建
    robertding
        15
    robertding  
       2021-05-19 13:22:12 +08:00
    @chogath 你会放弃用开源的东西的; 推荐尽早用飞书
    star7th
        16
    star7th  
       2021-05-19 13:24:27 +08:00
    如果说要追求开源,那非常推荐 showdoc https://github.com/star7th/showdoc
    star7th
        17
    star7th  
       2021-05-19 13:25:21 +08:00
    如果不追求开源,也可以尝试 showdoc 官方服务 https://www.showdoc.com.cn/
    janxin
        18
    janxin  
       2021-05-19 13:46:45 +08:00
    hugo/hexo 之类的这种就可以把
    ilxv
        19
    ilxv  
       2021-05-19 13:50:02 +08:00
    大厂开发的团队协作工具都不错,飞书、语雀、teambition…
    charlestang
        20
    charlestang  
       2021-05-19 14:31:15 +08:00
    我推荐一个,https://www.mkdocs.org/ MkDocs 是用 Python 实现的,感觉很清爽的样子,MarkDown 支持各种插件和皮肤,很适合文档。还有个现在公司里用的 Outline https://www.getoutline.com/ 这个也有点小清新,是 JS 实现的。
    chogath
        21
    chogath  
    OP
       2021-05-19 15:21:28 +08:00
    总结下,开源工具确实部署和维护上有些麻烦。

    @ilxv
    @zhengxiaowai
    @HerrDu
    @star7th

    老哥们推荐使用现成的工具确实是基于这层考虑的,最后我选择国内能访问的 wolai ;用于一小撮人的知识管理。
    CY4suncheng
        22
    CY4suncheng  
       2021-05-19 17:36:18 +08:00
    @chogath 哈哈,昨天刚充值的 wolai
    chogath
        23
    chogath  
    OP
       2021-05-19 17:51:08 +08:00
    @CY4suncheng 我怀疑你是托 (狗头
    limbo0
        24
    limbo0  
       2021-05-19 23:48:47 +08:00
    尝试过很多, 最后 typora + wikitten,
    自己只维护文件就好了
    doublechenpaul
        25
    doublechenpaul  
       2021-05-20 09:20:09 +08:00
    wolai 就是国内版的 notion,其实也没啥不好,我用的是 notion
    CY4suncheng
        26
    CY4suncheng  
       2021-05-20 10:51:08 +08:00
    @chogath 随便吧,用什么工具不用分高低贵贱吧,哈哈,其实我也想用 notion,毕竟免费了,但是不支持悬浮目录,还有最多 3 级标题,这两个很难受啊,而且 3 级标题这个应该不会改了,悬浮目录不知道什么时候能支持
    xingheng
        27
    xingheng  
       2021-05-20 13:19:04 +08:00
    xiaomimei
        28
    xiaomimei  
       2021-05-21 09:59:32 +08:00
    vuepress,outline
    llsquaer
        29
    llsquaer  
       2021-05-21 10:02:57 +08:00
    @zhengxiaowai 这笔记写的真不错
    关于   ·   帮助文档   ·   API   ·   FAQ   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   4198 人在线   最高记录 5497   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 21ms · UTC 02:24 · PVG 10:24 · LAX 19:24 · JFK 22:24
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.