MarkdownToHtmlConverter (Конвертер Markdown в HTML)

Версия: 1.0
Автор: Sujan Rai (@blindtechvisionary)
Лицензия: GNU General Public License v2.0

🧩 О дополнении

Markdown to HTML Converter — это многофункциональное дополнение для NVDA, которое позволяет пользователям легко конвертировать Markdown-содержимое (.md) в чистый, хорошо структурированный HTML — прямо из среды экранного доступа NVDA.

Этот инструмент особенно полезен для незрячих разработчиков, блогеров, писателей и технических специалистов, которые хотят писать в Markdown и генерировать HTML без переключения на сложные редакторы или помощи зрячих.

💡 Основные возможности

• 🖋️ Написание или вставка Markdown напрямую в диалоговое окно.
• 📂 Прикрепление файлов .md с мгновенной загрузкой их содержимого.
• 🔄 Живое преобразование Markdown в HTML с использованием мощной библиотеки Python markdown.
• 🧾 Копирование в буфер обмена, экспорт в .html или просто чтение результата напрямую.
• 🌐 Однокликовый доступ к:
  • 📌 Сайту дополнения
  • 📧 Поддержке по email
  • 📺 YouTube-каналу (Blind Tech Visionary)

⚙️ Как использовать

🛠️ Доступ к инструменту

После установки откройте конвертер через:

• Меню NVDA → Сервис → Markdown to HTML Converter
• Или нажмите комбинацию клавиш: NVDA + Shift + M

🧪 Пошаговая инструкция

1. Откройте диалоговое окно конвертера через меню инструментов NVDA.
2. Выберите одно из следующих действий:
   • Введите или вставьте Markdown в поле ввода.
   • Прикрепите Markdown-файл с помощью кнопки “Attach Markdown File”.
3. Нажмите Convert.
4. Преобразованный HTML будет отображён в отдельном диалоговом окне.
5. В окне результата вы можете:
   • Скопировать в буфер обмена
   • Экспортировать как .html
   • Закрыть диалоговое окно

🖥️ Скриншоты (для зрячих пользователей или документации)

Поскольку дополнение разработано для пользователей экранного доступа, скриншоты необязательны, но могут быть предоставлены при необходимости.

🔒 Конфиденциальность и оффлайн-использование

Это дополнение работает полностью оффлайн. Никакие данные не отправляются в интернет, если вы не решите открыть внешние ссылки (например, сайт или email).

🌍 Полезные ссылки

• 🔗 Посетить сайт
• 📺 Подписаться на YouTube-канал
• ✉️ Связаться по email

🛠️ Зависимости

Дополнение использует следующие библиотеки:

• markdown — Python-реализация Markdown
• wxPython — Для GUI-компонентов
• threading, webbrowser, os, ui, api — Встроенные модули NVDA и Python

🧾 Лицензия

Дополнение распространяется под лицензией GNU General Public License v2.0.

Вы можете свободно использовать, изменять и распространять это программное обеспечение на условиях GPL v2. Подробности см. в LICENSE.

🤝 Вклад и поддержка

Дополнение разработано с любовью и заботой о доступности. Вклад, отзывы и поддержка приветствуются!

Если вы хотите:

• Предложить код или улучшения: откройте pull request.
• Запросить функции или сообщить об ошибках: свяжитесь с нами или создайте issue.
• Поддержать автора: Подпишитесь на YouTube-канал или поделитесь дополнением!

📢 Атрибуция

Разработано Blind Tech Visionary с целью сделать редактирование Markdown и конвертацию в HTML доступными для всех пользователей NVDA.

🔐 Отказ от ответственности

Дополнение предоставляется как есть без каких-либо гарантий. Используйте на свой страх и риск.