mdx / mdd / css 三种格式到底是什么关系

三种文件的分工

一个完整的 mdx 词典通常由同名的三种文件组成，扩展名不同、职责各异：

• .mdx — 词典正文的主体，本质是经过压缩打包的 HTML。词条标题、释义内容、内部跳转链接都在里面。mdx 是必需文件，没有它词典无法打开。
• .mdd — 词典引用的资源素材包。真人发音音频、插图、视频片段等二进制资源打包在 mdd 里。mdd 是可选的——纯文本词典没有 mdd 也能正常显示。
• .css — 层叠样式表，控制词典的字体、颜色、布局。同样是可选的，不自带 css 的词典会使用 MDict 默认样式。

同一本词典的 mdx、mdd、css 文件文件名必须完全相同（只有后缀不同），MDict 才会自动关联。例如 牛津高阶.mdx、牛津高阶.mdd、牛津高阶.css 三件套放在同一目录下，软件就会识别为一本完整词典。

mdx 内部是什么

mdx 的本质是 HTML 的压缩封装。打包前的源文件（mtxt 或纯 HTML）写入词条标题和释义正文，每条词条用 <title> 标签标识，正文支持完整的 HTML+CSS 语法——也就是说，你能在 mdx 词典里看到富文本排版、表格、图片、甚至内嵌小视频。

MDict PC 版从 1.3 RC4 开始支持页内跳转和图片显示，Android 版 2.0+ 同样支持。这意味着你在制作词典时可以把 mdx 当成一个小型网页来写，自由度很高。

资源引用方式

mdx 文件中引用 mdd 里的资源时，格式形如 resource:///音频文件名.mp3。这个资源地址在打包时写入 mdx，运行时 MDict 根据文件名在同名 mdd 里查找并解压到临时目录。如果你删掉了 mdd 但保留了 mdx，词典正文还能看，但点击发音按钮或图片会报错。

版本演进

mdx 格式目前有 1.x 和 2.x 两个主要版本。MDXBuilder 4.0 会生成 2.x 格式，需要 MDict 2.0（PC / Android）或更高版本配合使用。旧版本 MDict 打开 2.x mdx 可能出现乱码或词条丢失，这在跨平台使用时需要注意——详见 版本兼容性排查。