Markdown到EPUB转换器Skill markdown-to-epub-converter

---

name: markdown到epub转换器 description: 将Markdown文档和聊天摘要转换为格式化的EPUB电子书文件，可在任何设备上阅读或上传到Kindle。

Markdown到EPUB转换器技能

此技能将Markdown文档转换为专业的EPUB电子书文件。适用于转换研究文档、博客文章、文章或聊天摘要为便携、设备无关的电子书格式。

概述

该技能接受多种格式的Markdown内容，并生成正确格式的EPUB3文件，兼容所有主流电子书阅读器，包括：

• Apple Books
• Amazon Kindle（通过Kindle for Mac/Windows/iOS/Android）
• Google Play Books
• Kobo和其他EPUB阅读器
• 任何标准EPUB阅读器

输入格式

选项1：原始Markdown文本

直接在消息中提供Markdown内容：

将此Markdown转换为EPUB：
# 我的书籍标题
## 第一章
这是第一章内容...

选项2：文件路径

提供要转换的Markdown文件路径。

工作原理

1. Markdown解析：分析您的Markdown并自动：

   • 将H1标题（#）视为章节边界
   • 将H2标题（##）视为章节内的部分标题
   • 保留格式（粗体、斜体、链接、列表、代码块）

2. 结构生成：创建正确的EPUB结构：

   • 从章节自动生成目录
   • 导航文档（EPUB3标准）
   • 元数据（标题、语言等）

3. 文件创建：生成有效的EPUB3文件，可供下载和使用

使用示例

示例1：转换博客文章

“将此Markdown博客文章转换为EPUB：

如何构建简单的Web服务器

引言

…内容…”

示例2：转换研究摘要

“我有Markdown格式的研究笔记。将它们转换为EPUB电子书。内容为：

研究项目：机器学习基础

第一章：基础

…”

示例3：转换聊天摘要

“将我们迄今为止的对话总结为Markdown并转换为EPUB以供参考”

输出

该技能生成可下载的EPUB文件，包括：

• 专业格式
• 自动目录
• 正确的章节结构
• 支持Markdown格式化元素：
  • 标题（所有级别）
  • 粗体和斜体文本
  • 超链接
  • 列表（有序和无序）
  • 代码块和内联代码
  • 引用块
  • 水平线

支持的Markdown元素

元素	Markdown	支持	备注
标题	# H1 到 ###### H6	完全	自动目录生成
粗体	**文本** 或 __文本__	完全
斜体	*文本* 或 _文本_	完全
链接	[文本](url)	完全	在电子书中可点击
列表	- 项目 或 1. 项目	完全	支持嵌套列表
代码块	```语言	增强	语法高亮就绪，等宽字体
内联代码	代码	增强	样式化背景，边框
表格	Markdown表格	增强	样式化标题，交替行
引用块	> 引用	完全	带左边框样式
水平线	--- 或 ***	完全

高级功能

增强代码块支持

代码块通过以下方式精美格式化：

• 高级等宽字体：SF Mono, Monaco, Fira Code, Consolas等
• 样式化背景：浅灰色背景带蓝色强调边框
• 语言检测：在```后指定语言以供未来语法高亮
• 正确转义：HTML字符安全转义
• 溢出处理：长行水平滚动

示例：

def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

增强表格支持

表格以专业样式渲染：

• 样式化标题：蓝色背景带白色文本
• 交替行：斑马条纹提高可读性
• 单元格填充：舒适间距便于阅读
• 内联格式：代码、粗体、斜体和链接在单元格中有效
• 响应式：表格适应不同屏幕尺寸

示例：

功能	状态	备注
标题	✓	完全支持
代码	✓	增强样式
表格	✓	专业布局

自定义标题和元数据

您可以指定EPUB元数据：

• 书籍标题（默认第一个H1标题）
• 作者姓名
• 语言
• 出版日期

章节组织

章节自动检测自：

• H1标题（#）作为主要章节分隔
• H1之间的逻辑内容部分
• 章节间自动分页

样式

生成的EPUB使用干净、可读的默认样式，：

• 尊重读者的字体偏好
• 适用于所有屏幕尺寸
• 保持适当间距和层次结构
• 包括合适的边距和填充

技术细节

• 格式：EPUB3（兼容所有现代阅读器）
• 编码：UTF-8
• HTML版本：XHTML 1.1
• CSS支持：响应式样式

下载您的EPUB

生成后，文件将可供下载。然后您可以：

1. 下载EPUB到计算机
2. 用您偏好的电子书阅读器打开
3. 传输到您的Kindle、iPad或其他设备
4. 通过电子邮件或云直接上传到Kindle

最佳结果提示

1. 使用正确的Markdown结构：当Markdown遵循标准约定时（H1用于标题，H2用于部分），该技能效果最佳

2. 清晰的章节分隔：使用H1标题明确标记章节划分

3. 描述性标题：标题成为目录，因此使其清晰和描述性

4. 内容组织：在标题之间逻辑放置内容

5. 支持的格式：坚持基本Markdown格式以获得所有阅读器的最佳兼容性

故障排除

EPUB无法打开：确保您的Markdown格式正确。检查链接中的匹配括号和正确语法。

目录为空：确保您的Markdown包括H1标题来定义章节。

格式看起来不同：EPUB阅读器应用自己的字体和样式。这是正常和预期的行为。

脚本

• epub_generator.py - 核心EPUB文件创建和格式化
• markdown_processor.py - Markdown解析和结构提取

未来增强

• 使用自定义图像自动生成封面页
• Kindle特定优化（.mobi格式）
• 每用户偏好的自定义CSS样式
• 多文档合并
• 图像嵌入和优化
• 高级元数据支持