导出转换

用 Markdown 写电子书 / EPUB:自出版与排版入门

想自己出一本小书、教程合集或文档手册?用 Markdown 写正文、工具一键转 EPUB/MOBI,比在 Word 里折腾排版省心得多。本文讲清项目结构到导出的全流程。

一、为什么用 Markdown 写书

写书最大的痛是“排版”——章节、目录、页码、字体反复调。Markdown 让你先专注内容,把排版交给工具:

  • 纯文本好版本化:每章一个 .md,Git 管理改动,误删可回滚。
  • 一次写作多端发布:同一份源能转 EPUB(电子书)、PDF(打印)、HTML(网页)。
  • 不被软件绑架:没有私有格式,换工具说走就走。

小技巧:先在 365Lab 编辑器 把每章写顺、预览满意,再合并进电子书项目,写作最稳。

二、一本电子书的项目结构

一个清晰的目录能省掉后面很多麻烦。典型结构如下:

my-book/
├── metadata.yml      # 书名、作者、语言等
├── cover.jpg         # 封面图
├── chapter-01.md     # 第一章
├── chapter-02.md     # 第二章
└── README.md         # 简介

metadata.yml 里放书名、作者、语言、标识符,转换工具会把它写进 EPUB 的“元信息”,阅读器才能正确显示书名和作者。

三、三种转换方案

1. Pandoc —— 万能转换器

pandoc chapter-*.md -o book.epub 一行就能把多篇 Markdown 合成 EPUB。支持目录、封面、样式,是技术作者的首选。

2. mdBook —— 专注“书”

Rust 写的电子书/文档框架,自带目录导航和阅读界面,适合教程、手册类书籍,输出既可以是网页也可以是 EPUB。

3. Typora / 编辑器导出

部分编辑器支持“导出为 EPUB”,适合单本小书、不想碰命令行的人。和 Markdown 转 PDF、转 Word 同一套导出思路。

方案命令行适合额外能力
Pandoc需要通用/技术书格式最全
mdBook需要教程/手册网页+电子书
Typora 导出不需要单本小书所见即所得

四、从写作到 EPUB 的步骤

  1. 分章写:每章一个 .md,用 # 写章标题。
  2. 加元信息:准备 metadata.yml 与封面图。
  3. 合并导出:pandoc chapter-*.md metadata.yml --epub-cover-image=cover.jpg -o book.epub。
  4. 校验:用阅读器(如 Apple Books、Calibre)打开,检查目录跳转和封面。

五、目录、封面与样式

EPUB 的“目录”由标题层级自动生成,所以规范使用 #/## 很重要。封面用一张图即可;想统一风格,可以写一段 CSS 控制正文字体、行距、标题样式。

想要打印版或给编辑的定稿,可同步导出 PDF;需要 docx 给出版社,见 Markdown 转 Word。简历类单篇排版可参考 用 Markdown 写简历。

六、常见问题

Q:EPUB 和 PDF 该用哪个?
A:EPUB 适合在手机/阅读器上流式阅读、能调字体;PDF 适合定稿打印、版面固定。两者都能从 Markdown 生成。

Q:Kindle 能看吗?
A:能。EPUB 可用 Calibre 转成 MOBI/AZW3 推送到 Kindle。

Q:图片怎么处理?
A:把图放进项目文件夹,用相对路径引用(写法见 Markdown 插入图片),转换时会一起打包进 EPUB。

Q:需要会编程吗?
A:用 Typora 这类编辑器导出完全不用;Pandoc/mdBook 才需要一点命令行。


先把 Markdown 基础打牢,看 Markdown 入门;格式转换细节见 转 PDF 与 转 Word;做网页版可参考 导出 HTML。

先把每章写顺,再合成电子书

用 365Lab 在线编辑器把每章 Markdown 写好、预览满意,再合并导出 EPUB,出书最省心。免注册、内容本地保存。

免费开始写作 →