Двойной клик по MDX-файлу открывает диалог «Выберите приложение», потому что Windows не знает этот формат — и первая проверка, которую стоит сделать, это выяснить, какой именно тип MDX у вас в руках. Под одним расширением скрываются два совершенно разных формата: MDX как Markdown с JSX-компонентами (используется разработчиками в документации и блогах) и MDX как словарная база MDict (электронные словари с текстом и аудио). От ответа на этот вопрос зависит выбор программы.
Определить тип файла просто: откройте его в любом текстовом редакторе, например в «Блокноте». Если перед вами читаемый текст на Markdown с вставками вроде <Component /> — это Markdown-вариант. Если видны нечитаемые символы и бинарные данные — скорее всего, это словарь MDict. Ниже разберём программы для обоих случаев.
Чем открыть MDX как Markdown с JSX
Формат MDX объединяет обычный Markdown и компоненты React, поэтому с ним работают те же инструменты, что и с кодом. Лучший выбор — редакторы с поддержкой подсветки синтаксиса и расширений для MDX.
- 📝 Visual Studio Code — бесплатный редактор с официальным расширением MDX из маркетплейса: подсветка, автодополнение и проверка синтаксиса работают из коробки после установки дополнения.
- 🧩 WebStorm / IntelliJ IDEA — поддержка MDX встроена в современные версии, удобно для проектов на Next.js или Gatsby.
- 📄 Obsidian и Typora — откроют файл как обычный Markdown, но JSX-вставки отобразятся как текст без рендеринга.
- 🌐 Онлайн-песочницы — playground на официальном сайте проекта MDX позволяет вставить код и сразу увидеть результат без установки программ.
Для разовой задачи — просто посмотреть содержимое — достаточно любого текстового редактора: Notepad++, Sublime Text или даже стандартного «Блокнота». Файл текстовый, ничего не испортится. А вот для полноценной работы с компонентами нужен редактор с расширением, иначе вы не увидите ни предпросмотра, ни диагностики ошибок.
Чем открыть MDX-словарь MDict
Словарные MDX-файлы — это упакованные базы данных, и текстовый редактор тут бессилен. Для них существует отдельный класс программ — оболочки для электронных словарей.
На Windows и Android исторически популярны оболочки MDict и GoldenDict: обе умеют подключать MDX-базы и показывать статьи с форматированием, картинками и озвучкой. На мобильных устройствах также встречаются приложения BlueDict и Eudic, которые поддерживают этот формат. Перед установкой проверьте в описании конкретной версии программы, что поддержка MDX заявлена — состав поддерживаемых форматов у оболочек различается.
Порядок подключения в большинстве таких программ одинаковый: скопируйте MDX-файл (и сопутствующие файлы ресурсов .mdd, если они есть) в папку словарей программы, затем обновите список словарей в настройках. Файлы .mdd содержат изображения и звук — без них словарь откроется, но мультимедиа-контент отображаться не будет.
Установка и настройка VS Code для работы с MDX
Разберём самый частый сценарий — настройку Visual Studio Code для MDX-документации. Шаги не зависят от версии операционной системы.
☑️ Настройка MDX в VS Code
После установки расширения откройте ваш файл и посмотрите на правый нижний угол окна — там отображается языковой режим. Если вместо MDX стоит Markdown или Plain Text, кликните по индикатору и выберите MDX вручную. Это включит корректную подсветку JSX-вставок.
Для предпросмотра готовой страницы одного редактора мало: MDX рендерится внутри проекта (Next.js, Gatsby, Docusaurus и т.п.). Обычно предпросмотр запускается командой из терминала проекта, например:
npm run devКонкретная команда зависит от вашего проекта — смотрите секцию scripts в файле package.json.
Сравнение программ для MDX
| Программа | Тип MDX | Платформа | Особенности |
|---|---|---|---|
| Visual Studio Code | Markdown + JSX | Windows, macOS, Linux | Расширение MDX, подсветка, диагностика |
| Notepad++ | Markdown + JSX | Windows | Только просмотр и правка текста |
| GoldenDict | Словарь MDict | Windows, Linux | Подключение MDX-баз, поиск по статьям |
| MDict | Словарь MDict | Windows, Android | Нативная поддержка формата, MDD-ресурсы |
| Obsidian | Markdown + JSX | Windows, macOS, Linux | Открывает как Markdown без рендера JSX |
⚠️ Внимание: не переименовывайте MDX-файл в.md или.txt «для совместимости», если файл является частью проекта или словаря — пути к файлу могут быть прописаны в конфигурации, и после переименования проект перестанет собираться, а словарь — подключаться.
Частые проблемы и их решения
Одна из типичных ситуаций — редактор открывает MDX, но ругается на синтаксис. Возможная причина: не установлено расширение MDX, и редактор трактует JSX-вставки как ошибки Markdown. Проверьте языковой режим файла и наличие расширения.
Вторая проблема касается словарей: оболочка видит MDX-файл, но статьи открываются без картинок и звука. Почти всегда дело в отсутствующих или неподключённых MDD-файлах ресурсов — они должны лежать в той же папке и иметь то же имя, что и основной MDX-файл.
Почему MDX из проекта не открывается предпросмотром отдельно
MDX-файлы проекта часто импортируют компоненты из других файлов и используют переменные окружения. Отдельно от сборки проекта такой файл не отрендерится — это нормально. Для просмотра запускайте dev-сервер проекта, а не ищите «просмотрщик MDX».
Третий сценарий — файл не открывается вообще и выдаёт ошибку чтения. Проверьте, не повреждён ли он: сравните размер с исходником, попробуйте скачать заново. Для словарей также убедитесь, что версия оболочки поддерживает версию формата конкретного файла — старые программы могут не читать базы, созданные новыми инструментами.
⚠️ Внимание: MDX-файлы из непроверенных источников могут содержать вредоносный JavaScript-код в JSX-вставках. Не запускайте сборку чужого MDX-проекта, не просмотрев содержимое файлов в текстовом редакторе.
Как конвертировать MDX в другие форматы
Прямой конвертации MDX в PDF или DOCX «в один клик» не существует из-за JSX-компонентов. Рабочий путь для Markdown-варианта: собрать проект в HTML через штатную команду сборки (обычно npm run build), а затем распечатать страницу в PDF из браузера.
Для словарей MDict существуют утилиты-конвертеры, извлекающие статьи в текстовые форматы, но их использование требует аккуратности с лицензиями: многие словарные базы защищены авторским правом, и их извлечение может нарушать условия использования.
FAQ: частые вопросы о MDX-файлах
Чем открыть MDX-файл на Windows без установки программ?
Любой MDX-файл можно открыть встроенным «Блокнотом»: правый клик → «Открыть с помощью» → «Блокнот». Текстовый вариант (Markdown + JSX) будет читаем, словарный покажет бинарные данные — это нормально, для него нужна специальная оболочка.
Чем MDX отличается от обычного Markdown (.md)?
MDX — надстройка над Markdown: помимо разметки он позволяет вставлять JSX-компоненты прямо в текст, например интерактивные блоки документации. Обычный Markdown таких вставок не поддерживает.
Почему VS Code не подсвечивает MDX-файл?
Проверьте два момента: установлено ли расширение MDX из маркетплейса и выбран ли языковой режим MDX в правом нижнем углу окна. Если файл определяется как Plain Text, смените режим вручную.
Что за файлы.mdd идут вместе со словарём.mdx?
Это файлы ресурсов словаря MDict: изображения, аудио, стили. Они должны лежать в одной папке с основным MDX-файлом и иметь то же имя, иначе мультимедиа-контент в статьях отображаться не будет.
Можно ли редактировать MDX-словарь?
Формат MDict — упакованная бинарная база, прямое редактирование в текстовом редакторе невозможно. Существуют инструменты для распаковки и сборки таких баз, но работа с ними требует технического опыта и учёта лицензионных ограничений на содержимое словаря.