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

2022-05-26 22:16:18 +08:00
 justwe7

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

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

但是:

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

2929 次点击
所在节点    程序员
15 条回复
hamsterbase
2022-05-26 22:19:49 +08:00
可以试试看 waque github.com/yesmeck/waque

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

左边是目录树,右边是大纲。
kytrun
2022-05-26 22:24:22 +08:00
docsify ,不需要打包,运行时解析 md ,可自定义程度蛮高的,当然也可以服务端渲染
linchengzzz
2022-05-26 22:28:26 +08:00
Meka
2022-05-26 22:41:29 +08:00
bojackhorseman
2022-05-26 22:43:49 +08:00
我用的 Facebook 的小恐龙,现在 react 阵营的文档基本都是用这个生成的。
omaidb
2022-05-27 08:31:46 +08:00
@bojackhorseman 哪个?小恐龙是啥,能提供个链接嘛
omaidb
2022-05-27 08:33:26 +08:00
用 md 写文档存在本地,有没有好的全文索引方法啊
lonr
2022-05-27 08:42:02 +08:00
creanme
2022-05-27 08:51:17 +08:00
hugo?
justwe7
2022-05-27 08:59:15 +08:00
感谢各位的建议,我去对比一下。粗略看 https://github.com/facebook/docusaurus 和我需求契合度挺高的
justwe7
2022-05-27 09:04:19 +08:00
@justwe7 我还看到一份工具对比,是写在 docusaurus 文档上的,有类似需求的同学也可以参考一下 https://docusaurus.io/zh-CN/docs#comparison-with-other-tools
muzihuaner
2022-05-27 12:21:32 +08:00
hexo
ada87
2022-05-27 16:10:38 +08:00
mkdocs
Envov
2022-05-27 19:18:18 +08:00
用 next 你这功能分分钟搞出来,甚至可以搞一个在线编辑器,保存后本地文件同步更新
justwe7
2022-05-28 12:19:28 +08:00
@Envov 不想花太多精力再弄了,现在 md+gitpage+travis 自动部署挺好的,写完提交就行(其实标题感觉写错了,不应该叫博客)。主要是方便自己查就好,博客用 ghost 搭的有,在线编辑功能也都有,但还是觉得 gitpage 好用

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/855544

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX