Markdown 转电子书,解压就能用

写技术文档常用 Markdown，但想放到电纸书上看，直接转成电子书往往一团糟：表格被拦腰截断、代码挤成一行、流程图变成乱码。这个工具专门解决这些。

一、安装

1. 下载压缩包，解压到任意文件夹，建议用英文路径。

2. 双击 md2epub.exe。

3. 不用装 Python、Pandoc 或任何依赖。

注意：exe 必须和 _internal 文件夹放在一起，不能只拷 exe。

二、转换：三步

1. 点“添加文件”或“添加文件夹”。

2. 按需填书名、作者，勾选封面、选分隔线方式；不填也能转。

3. 点“开始转换”，完成后再点“打开输出文件夹”。

电子书输出在源文件旁的 output 子文件夹，文件名取自书名。

三、各项功能

1. 批量转换：添加文件夹后整个目录一次性列出，逐个处理并显示结果。

2. 书名作者：自动识别；有 YAML 配置读配置，没有就读第一个大标题；单文件模式下可手动改。

3. 生成封面：勾选后自动用书名做封面，不用自己找图。

4. 分隔线优化：默认“智能精简”，只删紧贴标题和文档开头的装饰线，保留正文之间的真正分隔；也可选全部移除或保留原样。

5. 流程图：用 Mermaid 写的流程图、时序图会自动画成图片嵌入。需要联网，失败时保留为代码块，不会留白。

6. 目录：按标题层级自动生成，可点击跳转，无需设置。

7. 日志区：实时显示删了几条线、渲染几张图、每个文件的结果，可复制发给别人排错。

四、常见问题

1. 打开空白：不是文件坏了，WPS 不支持标准电子书格式，换掌阅、微信读书、Apple Books 即可。

2. 流程图没出来：检查网络。

3. 同名文件没覆盖：原文件被阅读器占用，工具会自动改用 .1 后缀。

4. 支持格式：.md、.markdown、.mdown、.mkd、.txt；不支持 Word 和 PDF。

工具只做一件事：让 Markdown 变成排版规整、能安心读的电子书。