HTML2MD - Blog Article Converter

Convert blog articles from Chinese platforms (CSDN, CNBLOG, WeChat) to Markdown/HTML format

中文 | English | Live Demo

---

✨ Features

• ✅ Multiple Platform Support: CSDN, CNBLOG, WeChat Official Account
• ✅ Dual Format Export: Markdown and HTML
• ✅ Batch Download: Process multiple URLs at once (comma-separated)
• ✅ CSDN Categories: Download entire category/column articles
• ✅ Clean Output: Remove ads, comments, and unnecessary elements
• ✅ Web UI: Simple browser interface
• ✅ API Mode: RESTful API for integration

---

🚀 Quick Start

Prerequisites

Java 17+
Maven 3.6+

Installation & Run

# Clone repository
git clone https://github.com/copyboy/html2md.git
cd html2md

# Build
mvn clean package

# Run
java -jar target/html2md.jar

# Access in browser
http://localhost:8090/tool/html2md

🌐 Try Live Demo

Online Tool: https://api.zhangqingdong.cn/tool/html2md

Just paste your article URL and click convert!

---

📖 Usage Examples

Single Article

# CSDN Article
https://blog.csdn.net/username/article/details/123456789

# CNBLOG Article  
https://www.cnblogs.com/username/p/123456.html

# WeChat Official Account
https://mp.weixin.qq.com/s/xxxxxxxxxxxxx

Batch Download

# Multiple URLs (comma-separated)
https://blog.csdn.net/user1/article/details/111,
https://www.cnblogs.com/user2/p/222.html,
https://mp.weixin.qq.com/s/xxx

CSDN Category

# Download entire category
https://blog.csdn.net/username/category_8584136.html

---

🛠️ Tech Stack

• Backend: Spring Boot 2.x
• HTML Parser: Jsoup
• Markdown Converter: Flexmark
• Web Server: Embedded Tomcat

---

📊 Supported Platforms

Platform	Status	Format	Batch	Notes
CSDN	✅	MD/HTML	✅	Supports categories
CNBLOG	✅	MD/HTML	✅	Use HTML if MD has issues
WeChat	✅	MD/HTML	✅	Official Account only
Juejin	⏳	-	-	Coming soon
Jianshu	⏳	-	-	Coming soon

---

🔧 API Usage

Convert Article

POST http://localhost:8090/api/convert
Content-Type: application/json

{
  "url": "https://blog.csdn.net/xxx/article/details/123",
  "format": "markdown"  // or "html"
}

Response

{
  "success": true,
  "title": "Article Title",
  "content": "# Article Content\n\n...",
  "author": "Author Name"
}

---

🎨 Screenshots

Click to expand

Web Interface:

• Simple input form
• Real-time conversion
• Download button

Output Example:

• Clean Markdown format
• Preserved code blocks
• Maintained image links

---

🤝 Contributing

Contributions are welcome!

Add New Platform Support

1. Add new platform enum in HostEnums
2. Get page content ID selector
3. Implement parser logic
4. Add tests
5. Submit PR

Code Style

# Run tests
mvn test

# Code format
mvn spotless:apply

---

📝 Changelog

v1.1.0 (Latest)

• ✨ Added WeChat Official Account support
• 🐛 Fixed CNBLOG code block issues
• 📝 Improved documentation

v1.0.0

• 🎉 Initial release
• ✅ CSDN & CNBLOG support

---

🙏 Acknowledgements

• Jsoup - HTML parser
• Flexmark - Markdown processor
• Spring Boot - Application framework

---

📄 License

MIT License

---

💬 Contact & Support

• Issues: GitHub Issues
• Email: copy_boy@126.com
• Blog: i.zhangqingdong.cn

---

⭐ Star History

If you find this project helpful, please give it a star! ⭐

---

Made with ❤️ by copyboy

---

English Version

🌏 HTML2MD - Blog Article Converter

Convert Chinese blog articles to Markdown/HTML format with ease

What is HTML2MD?

HTML2MD is a Java-based tool that helps you convert blog articles from popular Chinese platforms (CSDN, CNBLOG, WeChat Official Accounts) into clean Markdown or HTML format.

Perfect for:

• 📚 Content Migration: Move your articles to new platforms
• 💾 Backup: Archive your blog posts locally
• 📝 Reuse: Repurpose content for documentation
• 🔄 Format Conversion: Convert between HTML and Markdown

Key Features

1. Multi-Platform Support: Works with CSDN, CNBLOG, and WeChat
2. Clean Output: Removes ads, comments, and clutter
3. Batch Processing: Convert multiple articles at once
4. Live Demo: Try it online without installation
5. API Available: Integrate into your workflow

Quick Start Guide

# 1. Clone
git clone https://github.com/copyboy/html2md.git

# 2. Build
mvn clean package

# 3. Run
java -jar target/html2md.jar

# 4. Open browser
http://localhost:8090/tool/html2md

Usage

1. Paste article URL
2. Select output format (Markdown/HTML)
3. Click "Convert"
4. Download result

That's it! 🎉

Tech Stack

• Java 17+
• Spring Boot 2.x
• Jsoup (HTML parsing)
• Flexmark (Markdown)

Contributing

PRs welcome! Please:

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push and submit a PR

License

MIT License - see LICENSE file

---

⬆ Back to Top