Markdown to DOCX Converter

Десктопное приложение для конвертации Markdown файлов в DOCX с поддержкой LaTeX формул.

✨ Возможности

• 📄 Конвертация Markdown → DOCX
• 🔬 Поддержка LaTeX формул ($...$ и $$...$$)
• ⚙️ Настройка параметров форматирования
• 🎨 Современный UI на React + TailwindCSS
• 🖥️ Кроссплатформенное (Windows, macOS, Linux)

📋 Требования

• Node.js 18+ (скачать)
• Python 3.10+ (скачать)
• LaTeX (для рендеринга формул) - MiKTeX для Windows

🚀 Установка (Windows)

REM 1. Клонируйте репозиторий
cd markdown-converter

REM 2. Установите Node.js зависимости
npm install

REM 3. Установите Python зависимости
cd python
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
cd ..

REM 4. Установите LaTeX (опционально, для формул)
REM Скачайте и установите MiKTeX с https://miktex.org/

🎮 Запуск

Режим разработки

npm run dev

Запустит React (localhost:5173) и Electron одновременно.

Продакшен сборка

npm run dist

Создаст .exe и portable версию в папке dist/.

⚙️ Настройки

Параметр	Значение по умолчанию
Шрифт	Times New Roman, 14pt
Интервал	1.5 (полуторный)
Красная строка	1.27 см
Поля	Верх 2, Низ 2, Лево 3, Право 1.5 см

📝 Поддерживаемые элементы Markdown

• Заголовки H1-H6
• Параграфы
• Нумерованные списки (1., 2., 3.)
• Маркированные списки (•)
• Жирный текст (text)
• Курсивный текст (text)
• Цитаты (> quote)
• Инлайн код (code)
• Блок код
• LaTeX формулы ($E=mc^2$, $$\int...$$)

🏗️ Структура проекта

markdown-converter/
├── electron/           # Electron main process
│   ├── main.js
│   └── preload.js
├── python/             # Конвертер
│   ├── md2docx.py
│   └── requirements.txt
├── src/                # React components
│   ├── components/
│   │   ├── FileUploader.jsx
│   │   ├── Settings.jsx
│   │   └── Converter.jsx
│   ├── App.jsx
│   └── index.css
├── public/
│   └── index.html
├── package.json
├── vite.config.js
└── tailwind.config.js

📦 Сборка для дистрибуции

REM Windows - создаст установщик и portable версию
npm run dist

REM Результат в dist/:
REM - Markdown to DOCX Setup.exe (установщик)
REM - Markdown to DOCX.exe (portable)

Для других платформ используйте соответствующие команды bash.

🐛 Устранение проблем (Windows)

LaTeX формулы не рендерятся

• Установите MiKTeX с https://miktex.org/
• При первом запуске MiKTeX автоматически установит нужные пакеты

Ошибка "python not found"

• Убедитесь, что Python установлен и добавлен в PATH
• Проверьте: python --version в cmd
• При установке Python отметьте "Add Python to PATH"

Ошибка "venv\Scripts\activate"

• Используйте cmd, а не PowerShell
• Или в PowerShell: venv\Scripts\Activate.ps1
• Если ошибка политики выполнения: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Electron окно не открывается

• Запустите в режиме разработки: npm run dev
• Проверьте консоль на ошибки
• Убедитесь, что порт 5173 свободен

📄 Лицензия

MIT