介绍
npm (Node Package Manager) 是 Node.js 的包管理器,是目前最流行的包管理工具之一。npm 安装的包存储在本地目录中,可以供项目使用。markdown-pdf-marked是一个npm包,它可以将markdown文件转换为pdf文件。如果你需要将自己的markdown文档转换为pdf文件,那么markdown-pdf-marked是一个非常好的选择,本文将介绍如何使用markdown-pdf-marked。
安装markdown-pdf-marked
使用npm安装markdown-pdf-marked非常简单,只需要在控制台中运行以下命令即可:
npm install -g markdown-pdf-marked
这里我们使用了-g参数,它会将 markdown-pdf-marked 安装到全局环境中,这样我们就可以在任何地方使用 markdown-pdf-marked 命令了。
使用markdown-pdf-marked
markdown-pdf-marked 的使用非常简单,在控制台中运行以下命令即可将markdown文件转换为pdf文件:
markdown-pdf-marked input.md -o output.pdf
其中,input.md 是你要转换的 markdown 文档,output.pdf 是你要生成的 pdf 文档。你可以使用相对路径或绝对路径指定它们。
**注意:**这里输出路径的文件夹必须存在,否则会报错。
高级用法
markdown-pdf-marked 提供了很多用于控制生成PDF文件格式和内容的选项。
标题和页眉
markdown-pdf-marked input.md -o output.pdf --title "My Document" --header "<span style='color:red;'>My Header</span>"
这里,我们使用了 --title 选项来指定生成PDF文件的文档标题,使用了 --header 选项来指定页眉。
页码
markdown-pdf-marked input.md -o output.pdf --pdf-a1a --footer-center '[page]/[topage]'
这里,我们使用了 --pdf-a1a 选项来生成符合PDF/A-1a标准的PDF文件。使用 --footer-center 选项来指定页码显示在页脚中心位置,其中 '[page]/[topage]' 表示当前页码和总页码。
样式文件
markdown-pdf-marked input.md -o output.pdf --style style.css
这里,我们使用了 --style 选项来指定 css 样式文件。
处理markdown中使用的本地图片
处理markdown中使用的本地图片,可以使用以下语句
markdown-pdf-marked input.md -o output.pdf --pdf-background-canvas --pdf-scale 1 --pdf-quality 100 –css <(echo img {max-width: 100%;} > css/img-style.css) --html-sandbox "allow-same-origin"
其中,需要安装phantomjs,建议使用cnpm安装,安装命令:
cnpm -g install phantomjs
最后的css,需要针对图片调整max-width,如果你的css文件已经有重复的,请酌情添加
自定义字体
markdown-pdf-marked input.md -o output.pdf --font-family "Microsoft YaHei"
这里我们使用 --font-family 选项指定了字体。
示例
我们来看一下如何使用 markdown-pdf-marked 将 markdown 文档转为 pdf 文档。
我们有一个 markdown 文档 document.md
,其内容如下:
-- -------------------- ---- ------- - -------- ---- -- - ------ --------- -- ------- - ---- -- --- ----- -------- --- ---------- --- ---- -- --- ----- ----------- --- ---------- --- ---- -- --- ------ ----------- -- ------- - ---- -- --- ------ --------
现在我们可以运行以下命令将其转为 pdf 文档:
markdown-pdf-marked document.md -o document.pdf
上面的命令会生成一个名为 document.pdf
的 pdf 文件,内容与 document.md
相同。
另外,我们还可以使用高级选项对生成的 pdf 文件进行自定义,比如指定样式、页眉、页码等等。
总结
以上就是使用 markdown-pdf-marked 将 markdown 文档转为 pdf 文档的方法。我们可以根据自己的需要,使用不同的选项来控制输出结果的格式和内容。使用 markdown-pdf-marked 可以方便快捷地将 markdown 文档转换为 pdf 文档,为我们的文档阅读和分享带来了很大的便利。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600566b281e8991b448e2f69