Haddock 转 RTF转换器
所有处理都在你的设备上完成，大文件可能需要一点时间。
当对方的工具链老旧、受限或未知时，转成 RTF——它是哪儿都能打开的最大公约数富文本。如果你的文件还是 Haddock 格式，这个页面就是最快的捷径：Haddock 是 Haskell 生态的文档标记：附着在函数上的 -- 注释块，渲染成每个 Hackage 包自带的 API 文档。
本转换器通过 WebAssembly 完全在你的浏览器内运行——文件不会离开你的设备，全程无上传、无水印、无注册、无排队。支持一次拖入多个文件批量转换。
Haddock 与 RTF 的对比
| Haddock | RTF | |
|---|---|---|
| 数据结构 | 注释标记（--、'links'、@mono@） | ASCII + 反斜杠命令 |
| 最适合 | Haskell API 文档 | 追求最大兼容性的交接 |
如何将 Haddock 转换为 RTF
- 1
选择文件
选择你的 Haddock 文件。
- 2
立即转换
文件先转换成 Markdown（保留标题、列表与段落的中间格式），再重建为目标格式。
- 3
下载结果
下载 RTF——结构保留，复杂排版被简化。
关于 Haddock 格式
Haddock 是 Haskell 解释自己的方式：-- 注释块里的文档，用 '标识符链接'、@等宽@ 和 /斜体/ 标记，编译成 Hackage 上每个包都发布的 API 参考页。标记活在源码里，但格式自成一们小语言。
从源码注释里转出后，Haddock 文本变成普通结构化散文：Pandoc 把标题、代码块和标识符链接映射到 Markdown 或 HTML，API 知识得以进入手册、wiki 或静态站点生成器，无需重新打字。
+优点
- ✓文档与所描述的代码同处一地
- ✓跨 API 的标识符感知链接
- ✓整个 Haskell 生态的标准
!局限
- −只在 Haskell 项目里有意义
- −语法小，Haddock 之外输出器少
- −嵌在注释里——需先提取
关于 RTF 格式
RTF 是微软 1987 年的富文本格式，它经久不衰的原因很简单：文件是可读的反斜杠命令加纯 ASCII，任何时代写过的程序都能打开它。WordPad、Word、TextEdit、LibreOffice、上古主机编辑器——RTF 是格式化文本的最大公约数。
它承载粗体、斜体、字体、颜色、表格和图片，但版面保真度刻意保守——它是「带格式的文本」，不是「排好版的页面」。因此当接收方的工具链未知、老旧或受限时，RTF 是正确选择：处处能开，该有的格式都在。
+优点
- ✓几乎所有文字处理软件都能打开
- ✓纯文本基底——不会被邮件或老系统搞坏
- ✓不需要完整办公套件就能保留粗体/斜体/表格/图片
!局限
- −没有模板、宏或文档自动化
- −版面保真度远低于 DOCX/PDF
- −编码冗长，文件比 DOCX 大
为什么把 Haddock 转换成 RTF？
可以把它理解为：把文件搬进更合适它的容器。只在 Haskell 项目里有意义RTF 的做法不同：几乎所有文字处理软件都能打开如果这听起来正是你要做的事，直接转——几秒钟，文件不离开你的设备。
常见问题
Haddock 转 RTF 真的免费吗？
完全免费，无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗？
不会。转换通过 WebAssembly 完全在你的浏览器内完成，文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗？
可以。任何装有现代浏览器的设备都适用：Windows、macOS、Linux、安卓和 iOS，无需安装任何软件。
Haddock 转 RTF 有文件大小限制吗？
由于不上传，唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题，超大文件只是需要稍等片刻。
转换可以离线进行吗？
可以。页面加载完成后，转换完全在浏览器内运行——你甚至可以断网继续转换。任何文件都不会经过服务器。
转换出来的 RTF 之后还能编辑吗？
取决于目标格式：RTF 为自己的用途而生，本转换器忠实还原其内容，而不是凭空制造可编辑结构。需要大量再编辑时，请从面向编辑的格式入手，最后在这里导出终稿。