/

如何使用 Markdown 創建電子書

如何使用 Markdown 創建電子書

我的電子書創建流程

目前我有15本免費的書籍，我會免費分享給訂閱我的電子報的所有人。

其中有些書籍已經出到第二版（關於 JavaScript 和 React 的書籍），因為技術發展迅速，我們必須跟上腳步。

第一本書是在2018年出版的。

在不久的將來，我打算重新組織我的免費電子書集合，對其中的一些進行修訂，甚至可能新增一些新的書籍。

自從我最後一次更新到美妙的[2021 MacBook Pro 14”] (https://flaviocopes.com/macbook-pro-2021-review/)之後，我不得不在我的 Mac 上重新設置我的書籍創建工作流程，所以我趁機寫了這篇文章。

我使用一個叫做 honkit 的工具。

這是一個叫做 gitbook 的工具的分支，我以前一直在使用它，但是它已經被棄用很長時間了，不再可用。

honkit非常好用。它是一個用於使用 Markdown 創建書籍並生成 PDF / ePub / Mobi 版本的免費工具。

我可以更新一本書籍，只需一個命令就可以將它上傳到我的網站，並讓 CloudFlare 進行分發。

據我所知，這是迄今為止最簡單的工具，能夠生成所有這些書籍版本。

還有其他一些工具，但並不具備所有這些功能。

以下是開始使用的方法。

創建一個文件夾，並在其中添加一個 book.json 文件

1
2
3
4
{
 "author": "你的名字",
 "title": "書籍標題"
}

創建一個垂直的 cover.jpg 圖像，用於封面。如果你還想創建 ePub / Mobi 版本，可以再添加一個 cover_small.jpg。

創建一個 SUMMARY.md 文件，用於編寫目錄結構：

1
2
3
4
5
# 目錄

- [前言](README.md)
- [第一章](content/1-first.md)
- [第二章](content/2-second.md)

然後添加一個 README.md 文件，這是前言的 Markdown 文件。

添加一個 content/1-first.md 文件，這是第一章的 Markdown 文件。

以此類推。

現在下載 Calibre 並安裝它（或者使用 Homebrew 在 macOS 上運行 brew install --cask calibre）。

然後運行以下命令：

1
2
3
npx honkit pdf ./ ./book.pdf
npx honkit epub ./ ./book.epub
npx honkit mobi ./ ./book.mobi

這樣，PDF、ePub 和 Mobi（Kindle）版本的書籍就會出現在文件夾中了！

tags: [“markdown”, “ebooks”, “honkit”, “calibre”, “markdown-to-pdf”, “epub”, “mobi”]