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

---

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文件路径。

工作原理

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样式
• 多文档合并
• 图像嵌入和优化
• 高级元数据支持