Haddock 转 MD转换器
所有处理都在你的设备上完成，大文件可能需要一点时间。
Haddock 是 Haskell 生态的文档标记：附着在函数上的 -- 注释块，渲染成每个 Hackage 包自带的 API 文档。Markdown 是书写格式化文本最快的方式：本身易读，又能干净地转换为 HTML。
iLoveConverter 在你的电脑本地完成全部处理，因此既私密又快速：没有上传等待，不存储到任何服务器，也不限次数。想转多少文件都可以，批量转换开箱即用。
Haddock 与 MD 的对比
| Haddock | MD | |
|---|---|---|
| 数据结构 | 注释标记（--、'links'、@mono@） | 行级标记 |
| 类型与校验 | UTF-8 文本 | 无 |
| 兼容性 | Haskell、Hackage、Pandoc | GitHub、编辑器、SSG、笔记应用 |
| 最适合 | Haskell API 文档 | 文档、README、写作 |
如何将 Haddock 转换为 MD
- 1
选择文件
将 Haddock 文件拖放到上方区域，或点击选择。支持一次添加多个文件批量转换。
- 2
立即转换
点击"转换为 MD"。转换完全在你的浏览器内通过 WebAssembly 完成——不上传、无排队、无需等待。
- 3
下载结果
可逐个下载转换后的 MD 文件，也可以一次打包为 ZIP 全部下载。
关于 Haddock 格式
Haddock 是 Haskell 解释自己的方式：-- 注释块里的文档，用 '标识符链接'、@等宽@ 和 /斜体/ 标记，编译成 Hackage 上每个包都发布的 API 参考页。标记活在源码里，但格式自成一们小语言。
从源码注释里转出后，Haddock 文本变成普通结构化散文：Pandoc 把标题、代码块和标识符链接映射到 Markdown 或 HTML，API 知识得以进入手册、wiki 或静态站点生成器，无需重新打字。
+ 优点
- ✓文档与所描述的代码同处一地
- ✓跨 API 的标识符感知链接
- ✓整个 Haskell 生态的标准
! 局限
- −只在 Haskell 项目里有意义
- −语法小，Haddock 之外输出器少
- −嵌在注释里——需先提取
关于 MD 格式
Markdown（John Gruber，2004）是能渲染成富文本文档的纯文本：`#` 标题、`*` 强调、列表、链接、代码块。任何编辑器可写、原样可读、git 可 diff、二十年后照样打开——GitHub、Stack Overflow、Notion、Obsidian 和所有静态站点生成器都因此把文字内容托付给它。
唯一的诚实短板是方言碎片化：表格、脚注、任务清单最初都是扩展（GFM、MultiMarkdown、Pandoc），复杂文档在不同工具里渲染可能不同。核心 Markdown——标题、列表、链接、代码——在任何地方都稳如磐石。
+ 优点
- ✓面向未来的纯文本，随处可渲染
- ✓版本控制与文档的完美搭档
- ✓低摩擦：不渲染也能读
! 局限
- −扩展方言让高级特性碎片化
- −复杂排版与精确设计不在射程内
为什么把 Haddock 转换成 MD？
可以把它理解为：把文件搬进更合适它的容器。只在 Haskell 项目里有意义MD 的做法不同：面向未来的纯文本，随处可渲染如果这听起来正是你要做的事，直接转——几秒钟，文件不离开你的设备。
常见问题
Haddock 转 MD 真的免费吗？
完全免费，无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗？
不会。转换通过 WebAssembly 完全在你的浏览器内完成，文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗？
可以。任何装有现代浏览器的设备都适用：Windows、macOS、Linux、安卓和 iOS，无需安装任何软件。
Haddock 转 MD 有文件大小限制吗？
由于不上传，唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题，超大文件只是需要稍等片刻。
转换可以离线进行吗？
可以。页面加载完成后，转换完全在浏览器内运行——你甚至可以断网继续转换。任何文件都不会经过服务器。
Haddock 文件的排版会完全保留吗？
本转换器会把 Haddock 的内容渲染成 MD，在目标格式允许的范围内尽量保持页面、比例与图片原样。下载前请用预览确认效果符合预期。