Markdownify

🚀 Markdownify MCP 服務器（UTF - 8 版）

本項目是基於原始 Markdownify 項目的增強版本，專為更好地支持 UTF - 8 編碼而開發，能將多種格式文件轉換為 Markdown，為您的工作帶來便利。

🚀 快速開始

安裝要求

• 系統：支持 Windows、macOS 或 Linux。
• 依賴：需要安裝 Node.js（推薦版本：16+）和 Python 3.x。

安裝指南

步驟一：克隆倉庫

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

步驟二：安裝依賴

npm install
pip install -r requirements.txt

步驟三：啟動服務器

node dist/index.js

✨ 主要特性

主要改進

1. 全面的 UTF - 8 支持：整個項目經過優化，確保在處理中文和其他 UTF - 8 字符時表現更穩定。
2. Windows 系統兼容性提升：修復了 Windows 操作系統中的多項問題，提升了用戶體驗。
3. 改進的功能模塊：
   • 更強大的文件解析能力。
   • 支持更多文件格式（如 PDF、PPTX 和 XLSX）。
   • 提升對 YouTube 視頻的處理效率。
4. 增強的錯誤處理：包括更詳細的錯誤日誌和自定義輸出路徑功能。

與原項目的主要區別

• UTF - 8 支持優化：原項目在中文和其他非英語字符處理上存在一些問題，現版本已全面改進。
• Windows 系統支持增強：解決了 Windows 用戶在使用過程中遇到的多項問題。
• 新增功能：提供了更靈活的環境變量配置（如 UV_PATH 和 MARKDOWN_OUTPUT_DIR）。

功能

• 支持將多種格式文件轉換為 Markdown，包括 DOCX、PDF、PPTX、XLSX、YouTube 視頻鏈接、網頁內容。
• 提供命令行工具和桌面應用集成支持。
• 兼容 Node.js 和 Python 腳本環境。

💻 使用示例

命令行使用

基礎用法

將網頁轉換為 Markdown：

python convert_utf8.py "https://example.com"

高級用法

• 轉換本地文件
  • DOCX 文件：

python convert_utf8.py "document.docx"

- PDF 文件：

python convert_utf8.py "document.pdf"

- PowerPoint 文件：

python convert_utf8.py "presentation.pptx"

- Excel 文件：

python convert_utf8.py "spreadsheet.xlsx"

• 轉換 YouTube 視頻

python convert Utf8_py "https://www.youtube.com/watch?v=VIDEO_ID"

批處理操作

1. 創建一個包含要處理的 URL 或文件路徑的文本文件（例如 convert_batch.txt）：

https://example1.com
https://example2.com
file1.docx
file2.pdf

2. 運行以下命令進行批量處理：

while read -r line; do python convert_utf8.py "$line"; done < convert_batch.txt

環境變量配置

基礎用法

設置自定義路徑：

• 設置 UV 路徑：

export UV_PATH="/custom/path/to/uv"

• 設置輸出目錄：

export MARKDOWN_OUTPUT_DIR="/output/path"

高級用法

在 Python 腳本中使用這些環境變量。

桌面應用集成

基礎用法

配置 Node.js 環境：

node dist/index.js

高級用法

Python 腳本調用示例：

import subprocess

def convert_file(file_path):
    subprocess.run(["python", "convert Utf8_py", file_path])

if __name__ == "__main__":
    file_path = input("請輸入文件路徑：")
    convert_file(file_path)

⚠️ 重要提示

• 確保安裝正確依賴，Node.js 和 Python 版本需滿足要求。
• 處理大文件時注意性能，處理大型 PDF 或 PPT 文件可能需要更多內存和時間。
• 檢查錯誤日誌，遇到問題時，查看詳細日誌以快速定位。

🤝 貢獻與反饋

歡迎提交 Pull Request 和 Issue！

• 倉庫地址：https://github.com/JDJR2024/markdownify-mcp-utf8
• 提問或建議請聯繫：your.email@example.com

感謝您的支持！希望這個項目能為您的工作帶來便利。