A robust and feature-rich Dify plugin that converts HTML content to clean, formatted Markdown using multiple conversion methods.

This plugin has been successfully tested and is ready for deployment to Dify.

• Multiple Conversion Methods: Choose from 6 different HTML-to-Markdown conversion libraries
• High-Quality Output: Produces clean, well-formatted Markdown
• Robust Error Handling: Graceful fallbacks when conversion fails
• Configurable: Select the best conversion method for your use case
• Production Ready: Comprehensive testing and validation

1. trafilatura (default) - Excellent for web content and articles
2. markdownify - Clean, semantic conversion
3. html2text - Simple and reliable
4. pypandoc - Academic-grade conversion using Pandoc
5. beautifulsoup - Custom conversion with BeautifulSoup
6. simple - Basic fallback method

1. Install Dify CLI:

   brew tap langgenius/dify brew install dify

2. Install Dependencies:

   make install

1. Build the plugin package:

   make dify-package

2. Test locally with Dify CLI:

   ./dify-cli-latest plugin run ./dist/html_to_markdown.difypkg --enable-logs

3. Run comprehensive tests:

   python3 test_simple.py

✅ Plugin Loading: Successfully loads and responds to commands
✅ Tool Registration: html_markdown_converter tool properly registered
✅ Dependencies: All required libraries available
✅ Error Handling: Robust error handling and fallbacks

Sample test output:

🧪 Testing Plugin Loading ================================================== Plugin responses: info:{'info': 'loading plugin'} plugin_ready:{'info': 'plugin loaded'} ✅ Plugin loaded and responded 

1. Build the plugin (if not already done):

   make dify-package

2. Upload to Dify:

   • Open your Dify instance
   • Go to Plugins section
   • Upload ./dist/html_to_markdown.difypkg
   • Enable the plugin

3. Use in Workflows:

   • Add the "HTML to Markdown" tool to your workflow
   • Configure the conversion method
   • Pass HTML content as input

Tool: HTML to MarkdownProvider: html_markdown_converterParameters: html_content: "<h1>Hello World</h1><p>This is <strong>bold</strong> text.</p>"conversion_method: "trafilatura"

# Hello World This is **bold** text.

• html_content (required): The HTML content to convert
• conversion_method (optional): Choose from:
  • trafilatura (default)
  • markdownify
  • html2text
  • pypandoc
  • beautifulsoup
  • simple

1. Plugin won't load: Check that all dependencies are installed
2. Conversion fails: Try a different conversion method
3. Poor output quality: Use trafilatura or pypandoc for better results

If you encounter dependency issues, install them manually:

pip install trafilatura markdownify html2text pypandoc beautifulsoup4

For macOS with pandoc:

brew install pandoc

dify-html-to-markdown-plugin/ ├── manifest.yaml # Plugin manifest ├── main.py # Plugin entry point ├── provider/ # Provider configuration │ └── html_markdown_converter.yaml ├── tools/ # Tool implementation │ └── html_to_markdown.py ├── requirements.txt # Python dependencies ├── Makefile # Build automation └── dist/ # Built packages └── html_to_markdown.difypkg 

The plugin uses a comprehensive Makefile for development:

make help# Show all available commands make install # Install dependencies make validate # Validate configuration make dify-package # Build .difypkg file make clean # Clean build artifacts

Multiple test approaches are available:

1. Direct tool testing: python3 test_simple.py
2. Plugin daemon testing: Using Dify CLI
3. Integration testing: With actual Dify instance

The plugin uses a streamlined architecture that follows Dify's plugin framework:

1. main.py: Minimal entry point that lets the framework handle initialization
2. Tool Implementation: Clean, focused tool class with comprehensive error handling
3. Multiple Backends: Six different conversion methods for maximum reliability

• ✅ Simplified main.py without complex Plugin/DifyPluginEnv creation
• ✅ Robust error handling with fallback methods
• ✅ Comprehensive logging for debugging
• ✅ Multiple conversion options for different use cases
• ✅ Production-ready configuration

• v0.1.0: Initial working version with multiple conversion methods

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly with make test
5. Submit a pull request

This project is licensed under the MIT License - see the LICENSE file for details.

For issues or questions:

1. Check the troubleshooting section
2. Run tests to verify the issue
3. Open a GitHub issue with test results

🎉 Your HTML to Markdown plugin is ready for production use!