文档神器Docsify - 使用说明

1. 全局安装docsify

QQ截图20200723130839.png

2. 初始化项目

QQ截图20200723130915.png

初始化成功后，可以看到 `./docs` 目录下创建的几个文件
`index.html` 入口文件
`README.md` 会做为主页内容渲染
`.nojekyll` 用于阻止 GitHub Pages 会忽略掉下划线开头的文件
直接编辑 `docs/README.md` 就能更新网站内容，当然也可以写多个页面。

3. 本地预览网站

运行一个本地服务器，通过 docsify serve 可以方便的预览效果，而且提供 LiveReload 功能，可以实时的预览。默认通过 http://localhost:3000访问。

QQ截图20200723131153.png

4. 设置侧边导航栏

首先在 index.html 中添加一行配置：loadSidebar: true，如下图所示：

image
接着创建 _sidebar.md 文件，填写类似下面的内容： QQ截图20200723131644.png

Markdown 语法：表格

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

当然也有工具实现 excle 转 markdown

https://github.com/fanfeilong/exceltk
下载windows的exe文件，在文件下cmd，运行他的相关命令即可

Docsify 详细配置教程：

https://www.cnblogs.com/xhemj/p/How-to-Use-Docsify.html