0x0 从 markdown 生成 epub 文件

手机端电子阅读 APP，是可以导入 epub 格式的文件，所以会有这样的实际需求，即把一些文档资料、笔记都导入手机来阅读。

这里记录一下大概的步骤：

1、把文档资料、笔记等以 markdown 格式保存。考虑到文本格式化的趋势，各种相关编辑软件的出现，以及版本化的保存方式，markdown 以及其他文本格式十分普遍。

2、创建 title.txt，大概是这样的格式：

---
title:
- type: main
  text: XXX
  creator:
- role: author
  text: XXX
  cover-image: cover.jpg
rights: Public Domain
language: zh-CN
date: XXXX-XX-XX

3、使用 pandoc 工具：

按照 pandoc 的介绍，这是一款 a universal document converter：

a.epub: title.txt a.markdown b.markdown c.markdown
    pandoc -o $@ $(filter %.txt, $^) $(filter %.markdown, $^)

生成的速度取决于文档的尺寸。

4、导入手机。

0x1 一些注意点

pandoc 生成 xhtml 页面时，对源文件里的标签有比较严格的要求。从实际应用来看，对于 <br> 这种没有闭合的标签，会有编译报错，需要改用 <br/>。

0x2 字体

顺便提一下字体的问题。在 github 上面有一款非常出色的字体，叫霞鹜字体，免费开源。手机本身的字体显示，因为有主题以及版权等限制，只能从应用商店下载，所以没办法加载这款字体。但阅读 APP 里，却提供了导入第三方字体的入口。

# Tagged as epub, markdown, pandoc ·