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

用 Markdown 写博客,跟 vuepress 功能类似的有没有推荐的?

  •  
  •   justwe7 ·
    justwe7 · 2022-05-26 22:16:18 +08:00 · 3389 次点击
    这是一个创建于 915 天前的主题,其中的信息可能已经有所发展或是发生改变。

    一直用的 md 写写技术总结,为方便在线自查,选了 vuepress (小前端)

    vuepress 提供大纲,顶部导航(个人作为文章分类导航,切换查找也方便)功能。写了个小插件,自动匹配目录内的 md 文件作为导航入口,专注写 markdown 就好,使用体验也挺好的。

    但是:

    去年发现 vuepress 有了 v2 版本,虽然是 beta 版本,但界面是我的菜,简洁实用关键还增加了暗黑模式,也就花时间升级了。但是 beta 版的配置 api 老变来变去的,隔段时间打包就得报错又得折腾。锁版本都不太好使,萌生了换工具的想法。问下万能的 v 友有没有能满足我需求的工具作为替代的?

    15 条回复    2022-05-28 12:19:28 +08:00
    hamsterbase
        1
    hamsterbase  
       2022-05-26 22:19:49 +08:00
    可以试试看 waque github.com/yesmeck/waque

    用 markdown 写文档,然后同步到语雀。

    左边是目录树,右边是大纲。
    kytrun
        2
    kytrun  
       2022-05-26 22:24:22 +08:00 via Android
    docsify ,不需要打包,运行时解析 md ,可自定义程度蛮高的,当然也可以服务端渲染
    linchengzzz
        3
    linchengzzz  
       2022-05-26 22:28:26 +08:00
    Meka
        4
    Meka  
       2022-05-26 22:41:29 +08:00
    bojackhorseman
        5
    bojackhorseman  
       2022-05-26 22:43:49 +08:00 via iPhone
    我用的 Facebook 的小恐龙,现在 react 阵营的文档基本都是用这个生成的。
    omaidb
        6
    omaidb  
       2022-05-27 08:31:46 +08:00 via iPhone
    @bojackhorseman 哪个?小恐龙是啥,能提供个链接嘛
    omaidb
        7
    omaidb  
       2022-05-27 08:33:26 +08:00 via iPhone
    用 md 写文档存在本地,有没有好的全文索引方法啊
    lonr
        8
    lonr  
       2022-05-27 08:42:02 +08:00 via Android
    creanme
        9
    creanme  
       2022-05-27 08:51:17 +08:00
    hugo?
    justwe7
        10
    justwe7  
    OP
       2022-05-27 08:59:15 +08:00
    感谢各位的建议,我去对比一下。粗略看 https://github.com/facebook/docusaurus 和我需求契合度挺高的
    justwe7
        11
    justwe7  
    OP
       2022-05-27 09:04:19 +08:00   ❤️ 1
    @justwe7 我还看到一份工具对比,是写在 docusaurus 文档上的,有类似需求的同学也可以参考一下 https://docusaurus.io/zh-CN/docs#comparison-with-other-tools
    muzihuaner
        12
    muzihuaner  
       2022-05-27 12:21:32 +08:00 via Android
    hexo
    ada87
        13
    ada87  
       2022-05-27 16:10:38 +08:00 via Android
    mkdocs
    Envov
        14
    Envov  
       2022-05-27 19:18:18 +08:00
    用 next 你这功能分分钟搞出来,甚至可以搞一个在线编辑器,保存后本地文件同步更新
    justwe7
        15
    justwe7  
    OP
       2022-05-28 12:19:28 +08:00
    @Envov 不想花太多精力再弄了,现在 md+gitpage+travis 自动部署挺好的,写完提交就行(其实标题感觉写错了,不应该叫博客)。主要是方便自己查就好,博客用 ghost 搭的有,在线编辑功能也都有,但还是觉得 gitpage 好用
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3105 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 13:37 · PVG 21:37 · LAX 05:37 · JFK 08:37
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.