文章目錄

• • gitbook自帶的npm模塊gitbook
  • 使用vscode的插件Markdown PDF
  • 使用CommandBox GitBook Exporter

最近想把自己寫的一個(gè)gitbook轉(zhuǎn)成pdf分享出去，突然發(fā)現(xiàn)最新的gitbook版本已經(jīng)不支持導(dǎo)出PDF了。于是在網(wǎng)上找了好久終于被我發(fā)現(xiàn)了三個(gè)將gitbook轉(zhuǎn)換成pdf的方式，現(xiàn)分享給大家。我使用的是mac系統(tǒng)，如果是其他系統(tǒng)大家可以查找相應(yīng)的方案。

gitbook自帶的npm模塊gitbook

npm gitbook的最新版本是3.2.3，最新更新時(shí)間是1年前，官方估計(jì)已經(jīng)放棄這個(gè)模塊了。不過還好，這個(gè)模塊還能夠使用。 具體步驟如下：

安裝npm

通常來說，安裝好nodejs后會(huì)自動(dòng)安裝相應(yīng)的npm。

brew install nodejs

安裝gitbook

npm install gitbook -g npm install gitbook-cli -g

安裝calibre

直接到官網(wǎng)下載： https://download.calibre-ebook.com/

安裝好calibre之后，需要將 /Applications/calibre.app/Contents/MacOS/ebook-convert 鏈接到/usr/local/bin/ebook-convert

ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin/ebook-convert

生成PDF

在所有的一切都準(zhǔn)備好之后就可以運(yùn)行下面的命令生成pdf了。

gitbook pdf

注意，calibre要下載3.*版本，否則在gitbook pdf 的過程中會(huì)卡住。別問我是怎么知道的，我被這個(gè)問題坑了好久。

使用vscode的插件Markdown PDF

vscode是一個(gè)非常強(qiáng)大的文本編輯工具，我們可以可以使用它的Markdown PDF插件來將markdown來轉(zhuǎn)換成pdf。

它有一個(gè)markdown-it-include的功能，可以將一個(gè)markdown文件中引入的其他markdown文件包含進(jìn)來。

考慮下面的文件結(jié)構(gòu)：

├── [plugins] │ └── README.md ├── CHANGELOG.md └── README.md

如果我們新建一個(gè)md文件，其內(nèi)容如下：

README Content:[Plugins](./plugins/README.md):[Changelog](CHANGELOG.md)

導(dǎo)出為PDF之后，其內(nèi)容如下：

Content of README.mdContent of plugins/README.mdContent of CHANGELOG.md

這樣就可以通過一個(gè)文件來包含多個(gè)md文件。當(dāng)然這樣也有一個(gè)缺點(diǎn)就是引入的文件缺少層級(jí)概念也無法生成標(biāo)簽。

使用CommandBox GitBook Exporter

第三種方式就是使用forgebox的GitBook Exporter工具了。

方法如下：

安裝CommandBox

brew install commandbox

在box中安裝gitbook-exporter

box install gitbook-exporter

在gitbook控制頁面臺(tái)中，導(dǎo)出你要生成的gitbook的信息：
Advanced->Danger Zone->Export

導(dǎo)出PDF和html

CommandBox> gitbook export sourcePath=/path/to/ExportFolder

使用上面的命令可以同時(shí)導(dǎo)出pdf和html，其優(yōu)點(diǎn)就是比使用官方gitbook命令導(dǎo)出的文件要小很多，缺點(diǎn)就是pdf中文會(huì)出現(xiàn)亂碼（暫時(shí)沒有找到解決方法）

好了，三種方法都教給大家了，感覺去試一下吧。

更多精彩內(nèi)容且看：

• 區(qū)塊鏈從入門到放棄系列教程-涵蓋密碼學(xué),超級(jí)賬本,以太坊,Libra,比特幣等持續(xù)更新
• Spring Boot 2.X系列教程:七天從無到有掌握Spring Boot-持續(xù)更新
• Spring 5.X系列教程:滿足你對(duì)Spring5的一切想象-持續(xù)更新
• java程序員從小工到專家成神之路（2020版）-持續(xù)更新中,附詳細(xì)文章教程

更多教程請(qǐng)參考 flydean的博客

總結(jié)

以上是生活随笔為你收集整理的新版gitbook导出pdf的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。