docsify - 无需构建、轻量级的文档生成工具

[qingv]

一般习惯写小工具项目时写完文档就想弄一个页面出来，用 GitBook 感觉太重， GitHub 自带的又不支持多页（额好像是）。所以写了个小工具，部署后可以动态把 Markdown 文件渲染成网页。

好处就是只需要增加一个 html 入口文件，开启 GitHub 的 Pages 功能（选择 docs 作为源码目录）写完文档直接推送到仓库上就得到了一份文档网站 😄

• 文档地址： https://qingwei-li.github.io/docsify
• 项目地址： https://github.com/qingwei-li/docsify

目前提供 vue 和 buble 风格两套主题，还提供了命令行工具方便本地预览，欢迎尝试～

[neoz]

不错诶，赞！一会仔细看下

[Kilerd]

这套主题很好看！

[airyland]

赞

[gimp]

很棒，收藏了

[wq2016]

支持！

[DarsyCheuk]

mark

[huangfuyingjian]

很漂亮的主题，滋瓷一个，已 Star ：）

[mingyun]

不使用 username.github.io 使用其他 repo 的 gh-pages 分支可以吗

[qingv]

@mingyun 都可以呀 做法一样

[levie]

赞赞赞！
不知道能否设置左边的导航栏到 4 级（即 ####）就不要展开了？
因为想写成 FAQ 形式的，如果都展开的话就太占空间了。

[qingv]

@levie 自己写样式覆盖咯

[qingv]

@levie 想了下似乎可以设置成选项，下一个 patch 加上

[levie]

@qingv 谢谢

[levie]

另外，我这样写的时候：

## [ABC](/abc)

解析有问题（左边导航栏以及正文内容都是）
这样写是希望每个页面都有相同的导航栏，出现在正文内容的可以我通过 css 屏蔽掉。

[qingv]

@levie
目录最大层级功能已加， heading 渲染问题也修复了，已发布 0.3.1 。有 bug 或 feature 可以到 issue 里提 😄

[levie]

@qingv
赞！好的~

[guyskk]

手机 chrome 上代码块无法水平滚动

[yuanchao]

mark

[levie]

非常感谢 @qingv 这几日的更新，确实是非常好用的文档生成工具！
Snipaste 文档： https://docs.snipaste.com/zh-cn

[lawmil]

@qingv 貌似最近 1.1.0 好像有问题了。求更新，刚想试试

[qingv]

@lawmil 什么问题？

[kamal]

感谢分享，不用编译部署真方便。