介绍

mddoc 是一个开源的 markdown 文档转 html 文档工具,它使用 php 开发,支持 php >= 5.4。它生成的 html 可以直接放在网站上,支持全文搜索、自定义 html 模版。

mddoc 同时支持命令行、git webhook生成,不光可以本地生成后上传,也可以直接做成 webhook 自动部署生成,非常简单。

mddoc 兼容 GitBook Editor 编辑的格式,可以说 mddoc 是不想装 Node 环境又想使用 gitbook 的用户的一个非常好的选择。

其实我开发 mddoc 的本意,其实是因为我用的虚拟主机,不能装 Node 环境。想要实现 webhook 自动生成比较困难,所以就用 php 写了这个……

具体效果你现在看的这个文档就是使用 mddoc 生成哒!( https://doc.yurunsoft.com/mddoc )

Github:https://github.com/Yurunsoft/mddoc

Gitee:https://gitee.com/yurunsoft/mddoc

composer:yurunsoft/mddoc

命令行生成

首先通过 git 将项目拉取下来 执行composer update安装 执行php build.php -markdownPath "md文档路径" -htmlPath "html生成路径"

注意!html生成目录在生成前会被清空所有文件,请慎重选择目录!

默认生成使用的模版是mddoc/template下的,如果要指定自定义的模版路径,加上参数-templatePath "路径"

版权声明:

1、该文章(资料)来源于互联网公开信息,我方只是对该内容做点评,所分享的下载地址为原作者公开地址。
2、网站不提供资料下载,如需下载请到原作者页面进行下载。
3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考学习用!
4、如文档内容存在违规,或者侵犯商业秘密、侵犯著作权等,请点击“违规举报”。