name: markdown-to-epub-converter 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文件的路径。

工作原理

Markdown解析：分析您的Markdown并自动：
- 将H1标题（#）视为章节边界
- 将H2标题（##）视为章节内的部分标题
- 保留格式（粗体、斜体、链接、列表、代码块）
结构生成：创建正确的EPUB结构：
- 从章节自动生成目录
- 导航文档（EPUB3标准）
- 元数据（标题、语言等）
文件创建：生成一个有效的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

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

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

最佳结果提示

使用正确Markdown结构：技能在Markdown遵循标准约定时效果最佳（H1用于标题，H2用于部分）
清晰章节分界：使用H1标题明确标记章节划分
描述性标题：标题成为目录，因此使其清晰和描述性
内容组织：在标题间逻辑放置内容
支持格式化：坚持基本Markdown格式化以获得所有阅读器的最佳兼容性

故障排除

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

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

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

脚本

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

未来增强

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