在前端开发中，我们经常需要使用 markdown 编辑工具来写文档、README 等，以方便进行版本管理和分享。markdown-cli 是一个基于 node.js 的命令行工具，可用于将 markdown 格式的文本转换为 HTML 或 PDF 格式，从而方便我们进行阅读和分享。
安装
首先，我们需要通过 npm 安装 markdown-cli：
npm install -g markdown-cli
注意，这里的 -g 参数是全局安装，安装完成后我们就可以在任何地方使用 markdown-cli 命令了。
基本使用
markdown-cli 支持将 markdown 格式的文本转换为 HTML、PDF、EPUB 等格式。我们可以通过简单的命令来进行转换，例如：
markdown-cli doc.md -o doc.html
其中，-o 参数表示输出文件的路径和名称（这里输出为 doc.html）。如果我们需要将 markdown 转换为 PDF 格式，可以使用以下命令：
markdown-cli doc.md -o doc.pdf
注意，转换为 PDF 格式时，需要依赖于 wkhtmltopdf 工具。我们可以在 官网 上下载对应的版本，安装完成后便可以正常转换 PDF 格式。
自定义样式
有时候我们需要根据自己的需求，设置输出 HTML 或 PDF 文件的样式。markdown-cli 通过提供自定义样式表的方式，使我们可以轻松地进行样式定制。
首先，我们需要准备一份 CSS 样式表。例如，下面是一份简单的样式表示例：
-- -------------------- ---- ------- ---- - ------------ --------- ---- ---------- ------ ------- -------- ------ ----------- ---------- ----- ------------ ---- ------ ----- - --- --- --- --- --- -- - ------------ ----- ------ ----- - - - ------ -------- ---------------- ----- - ---- - ------------ --- ------ ----------- ---------- ---------- ----------------- -------- -------- --- ---- -------------- ---- -展开代码
保存该样式表为 style.css 文件。然后，我们可以通过以下命令来将 markdown 文件和样式表一起输出为 HTML 格式：
markdown-cli doc.md -s style.css -o doc.html
其中，-s 参数表示指定样式表文件路径。这样，我们就可以使用自定义的样式来美化输出的 HTML 文件了。
小结
markdown-cli 是一个非常实用的命令行工具，在我们进行 markdown 文档编辑和输出时，可以大大提升效率。在使用过程中，我们应该注意命令行参数的含义和用法，特别是在转换为 PDF 格式时，需要正确安装相关工具。同时，通过自定义样式表，我们可以轻松地进行输出样式的定制，使输出文档更加美观。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/70881
