MDXBuilder 4.0 — 从零制作 mdx 词典的官方打包工具

工具定位

MDXBuilder 是 MDict 生态里最成熟的词典编译工具——它能把人类可读的源文件（纯文本或 HTML）编译成 MDict 能读的 .mdx（词典正文）和可选的 .mdd（资源包）。FreeMdict Forum 上绝大部分精品词典（牛津高阶、韦氏、剑桥在线版等）都是用 MDXBuilder 制作的。

版本选择

MDXBuilder 目前有三个版本分支，4.0 是官方当前推荐的版本：

4.0 RC2 提供 32 位版和 64 位版两个下载包，解压后都只有一个 EXE 文件，不需要安装。官网下载页面在 PC 版下载区的"制作工具"段。

编译流程概览

准备源文件（mtxt 或 HTML） → 放入资源文件夹 → 运行 MDXBuilder → 输出 .mdx + .mdd

MDXBuilder 支持两种源格式：

1. mtxt 格式（推荐新手）：纯文本，每条词条用特定分隔符标记，不用学 HTML，上手最快；
2. HTML + CSS 格式（进阶）：每条词条就是一小段 HTML，可以加样式、表格、图片、甚至嵌入 JS。

mdtt（第三方 Python 工具）只支持 mtxt 格式，但优势是可以命令行调用、适合批量制作和 CI 自动化——如果你要做几十本词典，mdtt 比 MDXBuilder 的 GUI 高效得多。

4.0 版新特性

相比 3.0，MDXBuilder 4.0 最重要的改进：

• mdd 分卷输出：可以分别输出单词发音 mdd、例句发音 mdd、图片资源 mdd，用户可以按需删减、灵活瘦身；
• 更大的单文件支持：旧版 mdx 单个词条正文有 64KB 限制，4.0 提到 1MB，可以支持超长的百科词条；
• Unicode 更完善：更好地处理多语言、特殊符号、Emoji 等；
• 资源路径支持相对路径：3.0 版资源必须用绝对路径或固定前缀，4.0 可以用相对路径，源文件组织更灵活。

注意事项

4.0 版制作的词典必须 MDict 2.0（PC）或 MDict Android 2.0+ 配合使用。旧版 MDict 打开 mdx 2.x 格式可能出现词条丢失、图片不显示或直接报错。制作完成后在 FreeMdict Forum 发布资源时，一定要在帖子标题或前言里标注"需要 MDict 2.0 以上版本"。

新手推荐路线

如果你是第一次做词典，推荐按以下顺序学习：

1. 先读官方 manual.txt：MDXBuilder 4.0 压缩包里自带了 manual.txt 和 manual_Chn.txt（中文版），里面详细说明了 mtxt 格式规范、HTML+CSS 词典的写法、资源引用方式。这份文档是"圣经级别"的参考；
2. 找一本小词典练手：从 FreeMdict Forum 下载一本结构简单的小词典（比如只有几百词条的短语手册），用 7-Zip 打开它的 mdx 看看实际的源文件长什么样——反过来推更容易理解格式要求；
3. 用 mtxt 格式起步：先学纯文本 mtxt 格式，等能稳定输出 mdx+mdd 后再尝试 HTML 排版；
4. 在 FreeMdict Forum 的"词典编修"板块提问：该板块有大量老手活跃，遇到具体问题在那里发帖比百度搜索高效得多。

mtxt 源文件格式的详细说明见 mtxt 格式详解。