简介
docpub是一个可发布在线文档的npm包，它可以快速地将你的markdown文档转换成一个美观的HTML页面。
使用docpub，你可以将你的文档直接发布到GitHub Pages、gitlab pages、AWS、Heroku等多个在线平台，同时，docpub还提供一个支持自定义主题色的CSS文件来让你的文档更加独特。
安装
你可以在终端中使用npm来安装docpub包：
npm install -g docpub
安装完成后，你可以在任何目录下使用docpub。
使用
docpub支持简单的命令行调用，例如：将你的markdown文档转换成一个HTML页面。
docpub myDoc.md
这个命令将把你的markdown文件myDoc.md转换成一个HTML页面。
你可以通过运行以下命令来选择不同的输出目录：
docpub myDoc.md --output /path/to/directory
如果你需要选择一种自定义主题色，你可以运行以下命令：
docpub myDoc.md --brand-color "#0080ff"
品牌颜色将应用于整个HTML页面的主色调。
你还可以使用docpub提供的CSS文件，将你的文档的外观调整得更加优美。只要把 @import语句放在您的文档的 head 标签中即可：
<link href="./node_modules/docpub/docpub.css" rel="stylesheet">
深度和学习意义
docpub是一个解决基本需求的npm包，但是，它极大简化了我们将markdown文件发布为HTML页面的过程。
更重要的是，之前我们转换markdown文本到HTML页通常需要使用第三方库，如markdown-it和cheerio等开源npm包来构建一个HTML页面，可能需要花费一些时间和学习成本。但是docpub帮助我们节约了这些时间成本，同时它还提供许多有用的功能，如自定义主题色，在线打印等。
示例代码
你可以在我编写的 此markdown文件，看到docpub的示例代码，我们可以简单地使用以下命令即可构建文档：
npm run build
这将生成一个名为dist的文件夹，里面包含了我们生成的HTML页面。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005570b81e8991b448d3f55