Markdown to HTML Converter for NVDA

Version: 1.0
Author: Sujan Rai (@blindtechvisionary)
License: GNU General Public License v2.0

🧩 About the Add-on

Markdown to HTML Converter is a feature-rich NVDA add-on that empowers users to seamlessly convert Markdown (.md) content into clean, well-formatted HTML — all from within the NVDA screen reader environment.

This tool is especially useful for blind developers, bloggers, writers, and technical professionals who want to write in Markdown and generate HTML without switching to complex editors or relying on sighted assistance.

💡 Key Features

• 🖋️ Write or Paste Markdown directly into the dialog box.
• 📂 Attach .md Files and instantly load their contents.
• 🔄 Live Conversion of Markdown to HTML using powerful Python markdown library.
• 🧾 Copy to Clipboard, Export to .html, or just read the output directly.
• 🌐 One-click access to:
• 📌 Add-on Website
• 📧 Email Support
• 📺 YouTube Channel (Blind Tech Visionary)

⚙️ How to Use

🛠️ Accessing the Tool

Once installed, access the converter via:

• NVDA Menu → Tools → Markdown to HTML Converter
• Or press the keyboard shortcut: NVDA + Shift + M

🧪 Step-by-Step Instructions

1. Open the converter dialog from the NVDA tools menu.
2. Choose from the following:
3. Type or paste Markdown in the input box.
4. Attach a Markdown file using the "Attach Markdown File" button.
5. Click Convert.
6. The converted HTML will be displayed in a separate dialog.
7. In the result dialog, you can:
8. Copy to Clipboard
9. Export as .html
10. Close the dialog

🖥️ Screenshots (For Visual Users or Documentation)

As this is designed for screen reader users, screenshots are optional but can be provided if needed.

🔒 Privacy and Offline Use

This add-on runs 100% offline. No data is sent to the internet unless you choose to open external links like the website or email.

🌍 Useful Links

• 🔗 Visit Website
• 📺 Subscribe to YouTube Channel
• ✉️ Contact via Email

🛠️ Dependencies

This add-on uses the following libraries:

• markdown — Python implementation of Markdown
• wxPython — For GUI components
• threading, webbrowser, os, ui, api — Built-in NVDA and Python modules

🧾 License

This add-on is licensed under the GNU General Public License v2.0.

You are free to use, modify, and distribute this software under the terms of the GPL v2. See LICENSE for details.

🤝 Contribution & Support

This add-on is developed with love and accessibility in mind. Contributions, feedback, and support are welcome!

If you'd like to:

• Contribute code or improvements: please open a pull request.
• Request features or report bugs: feel free to contact or open an issue.
• Support the creator: Subscribe to the YouTube channel or share the add-on!

📢 Attribution

Developed by Blind Tech Visionary with the goal of making Markdown editing and HTML conversion accessible for all NVDA users.

🔐 Disclaimer

This add-on is provided as-is without any warranty. Use at your own risk.