UTF-8 인코딩 지원 및 다국어 콘텐츠의 최적화된 처리와 함께 원래 Markdownify MCP 프로젝트의 향상된 버전입니다.

English한국어

향상

• 종합 UTF-8 인코딩 지원 추가
• 다국어 콘텐츠 최적화
• Windows 시스템의 고정 인코딩 문제
• 향상된 오류 처리 메커니즘

Original Project의 핵심 차이점

1. 강화된 기호화 지원:

• 모든 가동의 전체 UTF-8 지원
• 중국어, 일본어, 한국어, 기타 비-ASCII 문자 처리
• Windows 별 인코딩 문제 수정 (cmd.exe 및 PowerShell 호환성)

2. 개량된 과실 취급:

• 영어 및 중국어 모두의 상세한 오류 메시지
• 네트워크 문제에 대한 더 나은 예외 처리
• 변환 실패를 위한 Graceful fallback 기계장치

3. 장시간 기능:

• 일괄 처리에 대한 지원 추가
• 향상된 YouTube 비디오 transcript 처리
• 다양한 파일 형식의 향상된 메타데이터 추출
• 문서 형식의 더 나은 보존

4. 성과 최적화:

• 대용량 파일 변환에 최적화된 메모리 사용
• 다국어 콘텐츠의 빠른 처리

Markdownify MCP Server - UTF-8 Enhanced

This is an enhanced version of the original Markdownify MCP project, with improved UTF-8 encoding support and optimized handling of multilingual content.

中文文档

Enhancements

• Added comprehensive UTF-8 encoding support
• Optimized handling of multilingual content
• Fixed encoding issues on Windows systems
• Improved error handling mechanisms

Key Differences from Original Project

1. Enhanced Encoding Support:

   • Full UTF-8 support across all operations
   • Proper handling of Chinese, Japanese, Korean and other non-ASCII characters
   • Fixed Windows-specific encoding issues (cmd.exe and PowerShell compatibility)

2. Improved Error Handling:

   • Detailed error messages in both English and Chinese
   • Better exception handling for network issues
   • Graceful fallback mechanisms for conversion failures

3. Extended Functionality:

   • Added support for batch processing multiple files
   • Enhanced YouTube video transcript handling
   • Improved metadata extraction from various file formats
   • Better preservation of document formatting

4. Performance Optimizations:

   • Optimized memory usage for large file conversions
   • Faster processing of multilingual content
   • Reduced dependency conflicts

5. Better Development Experience:

   • Comprehensive debugging options
   • Detailed logging system
   • Environment-specific configuration support
   • Clear documentation in both English and Chinese

Features

Supports converting various file types to Markdown:

• PDF files
• Images (with metadata)
• Audio (with transcription)
• Word documents (DOCX)
• Excel spreadsheets (XLSX)
• PowerPoint presentations (PPTX)
• Web content:
  • YouTube video transcripts
  • Search results
  • General web pages
• Existing Markdown files

Quick Start

1. Clone this repository:

   git clone https://github.com/JDJR2024/markdownify-mcp-utf8.git
   cd markdownify-mcp-utf8
   

2. Install dependencies:

   pnpm install
   

   Note: This will also install uv and related Python dependencies.

3. Build the project:

   pnpm run build
   

4. Start the server:

   pnpm start
   

Requirements

• Node.js 16.0 or higher
• Python 3.8 or higher
• pnpm package manager
• Git

Detailed Installation Guide

1. Environment Setup

1. Install Node.js:

   • Download from Node.js official website
   • Verify installation: node --version

2. Install pnpm:

   npm install -g pnpm
   pnpm --version
   

3. Install Python:

   • Download from Python official website
   • Ensure Python is added to PATH during installation
   • Verify installation: python --version

4. (Windows Only) Configure UTF-8 Support:

   # Set system-wide UTF-8
   setx PYTHONIOENCODING UTF-8
   # Set current session UTF-8