Haddock 转 POTM转换器
所有处理都在你的设备上完成，大文件可能需要一点时间。
Haddock Documentation与PowerPoint Macro-Enabled Template的定位并不相同：Haddock 是 Haskell 生态的文档标记：附着在函数上的 -- 注释块，渲染成每个 Hackage 包自带的 API 文档。POTM 模板的文字与结构提取方式和任何 PPTX 相同。
由于整个转换都在你的设备上完成，它快速、无限量且真正私密——无需账号、没有水印、文件不会出现在任何服务器上。多个文件一次性转换。
Haddock 与 POTM 的对比
| Haddock | POTM | |
|---|---|---|
| 数据结构 | 注释标记（--、'links'、@mono@） | OOXML zip：幻灯片 + 媒体 |
| 兼容性 | Haskell、Hackage、Pandoc | Office 2007+、谷歌幻灯片、WPS |
| 最适合 | Haskell API 文档 | 幻灯片及其内容 |
如何将 Haddock 转换为 POTM
- 1
选择文件
选择你的 Haddock 文件。
- 2
立即转换
文件先转换成 Markdown（保留标题、列表与段落的中间格式），再重建为目标格式。
- 3
下载结果
下载 POTM——结构保留，复杂排版被简化。
关于 Haddock 格式
Haddock 是 Haskell 解释自己的方式：-- 注释块里的文档，用 '标识符链接'、@等宽@ 和 /斜体/ 标记，编译成 Hackage 上每个包都发布的 API 参考页。标记活在源码里，但格式自成一们小语言。
从源码注释里转出后，Haddock 文本变成普通结构化散文：Pandoc 把标题、代码块和标识符链接映射到 Markdown 或 HTML，API 知识得以进入手册、wiki 或静态站点生成器，无需重新打字。
+优点
- ✓文档与所描述的代码同处一地
- ✓跨 API 的标识符感知链接
- ✓整个 Haskell 生态的标准
!局限
- −只在 Haskell 项目里有意义
- −语法小，Haddock 之外输出器少
- −嵌在注释里——需先提取
关于 POTM 格式
PPTX 是现代 PowerPoint 幻灯片：一个由 XML 部件组成的 ZIP 包，描述幻灯片、形状、文字与媒体。这个结构正是无需 PowerPoint 也能忠实提取文字的原因——每张幻灯片上的每个词都在包里，还带着页码。
一个诚实的边界：提取的是「词」而非「貌」。版式、背景、动画和图片不会出现在文本导出里——输出的是幻灯片的内容，而不是它的照片。
+优点
- ✓文字与页序完整保留
- ✓PowerPoint、Keynote、WPS、幻灯片皆可打开
- ✓Zip+XML 结构对机器友好
!局限
- −文本导出丢失版式与视觉
- −图表与表格被摊平成文字
为什么把 Haddock 转换成 POTM？
这个转换之所以存在，是有具体原因的：只在 Haskell 项目里有意义POTM 则绕开了这一点——文字与页序完整保留如果你正处在这种情况，用上面的工具几秒就能解决，全程都在你自己的设备上。
常见问题
Haddock 转 POTM 真的免费吗？
完全免费，无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗？
不会。转换通过 WebAssembly 完全在你的浏览器内完成，文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗？
可以。任何装有现代浏览器的设备都适用：Windows、macOS、Linux、安卓和 iOS，无需安装任何软件。
Haddock 转 POTM 有文件大小限制吗？
由于不上传，唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题，超大文件只是需要稍等片刻。
可以转换有密码的幻灯片吗？
不行——受保护的幻灯片在包内是加密的，请先在原软件中取消保护。
转换会包含图片和背景吗？
不包含。这是文字提取：幻灯片上的文字会保留，版式、背景、动画和图片不会。需要视觉效果请保留原文件。