Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi MarkItDown đổi được PDF, PowerPoint, Word, Excel, ảnh, âm thanh, HTML, CSV, JSON, XML, ZIP, EPUB và link YouTube sang Markdown, giữ lại tiêu đề, danh sách, bảng và link. | README |
|---|---|---|
| Ưu | Bài so sánh công cụ PDF sang Markdown của Jimmy Song (09/2025) đánh giá MarkItDown cài bằng pip dễ, đọc được nhiều loại file, hợp khi cần rút chữ nhanh hoặc đổi cả loạt file khác loại. | Jimmy Song, blog |
| Ưu | Plugin của bên thứ ba bị tắt sẵn; phải thêm --use-plugins thì chúng mới chạy. | README, Plugins |
| Nhược | Issue #293 (mở từ 01/2025, vẫn mở): bảng trong PDF bị dàn sai, số liệu không còn thẳng hàng với cột. Bài của Jimmy Song cũng ghi PDF ra chữ trơn, mất cấp tiêu đề và bố cục. | Issue #293 |
| Nhược | Cài bản [all] thì đổi file âm thanh sẽ gửi đoạn audio lên dịch vụ nhận giọng nói của Google (hàm recognize_google). File ghi âm cuộc họp nội bộ vì thế rời khỏi máy bạn. | converters/_transcribe_audio.py |
| Nhược | Gói lõi bắt buộc kéo theo magika và onnxruntime nên khá nặng. Issue #1234 (vẫn mở) kể người dùng vượt giới hạn dung lượng của AWS Lambda và DigitalOcean Functions, và cài lỗi trên Python 3.14. | Issue #1234 |
| Nhược | README của bản MCP ghi server không có đăng nhập; tool convert_to_markdown đọc được mọi file mà tài khoản chạy server đọc được và tải được mọi URL, và mọi tiến trình khác trên cùng máy đều gọi được nó. | markitdown-mcp README, Security Considerations |
| Chưa rõ | Bản 0.1.9 đã có code dựng bảng bằng pdfplumber, viết sau ngày mở issue #293. Mình không chạy thử nên chưa biết lỗi bảng trong PDF đã hết hay chưa. | converters/_pdf_converter.py |
| Chưa rõ | README không nhắc Claude Code hay Codex; README của bản MCP chỉ hướng dẫn cho Claude Desktop qua Docker. Với Claude Code, cách tác giả ghi sẵn là gọi lệnh markitdown trong shell. | markitdown-mcp README |
Khi nên dùng
- Bạn cần đưa nhanh nội dung file Word, Excel, PowerPoint hay PDF chữ thường cho agent đọc, và chấp nhận mất một phần bố cục.
Khi không nên dùng
- PDF có bảng phức tạp hoặc cần giữ đúng cấp tiêu đề, file âm thanh không được gửi ra ngoài, hoặc bạn định mở bản MCP cho máy khác gọi tới.
Cách cài
CLI
pip install 'markitdown[all]==0.1.9'Claude Desktop (MCP)
git clone https://github.com/microsoft/markitdown && cd markitdown && git checkout 7482c092d9c0074a89803c9fdb63a969e7fe17fc && cd packages/markitdown-mcp && docker build -t markitdown-mcp:latest . # rồi thêm mục "markitdown" vào claude_desktop_config.json như READMENó chạm vào những gì
- File đọc và ghi
- Đọc file bạn đưa vào. Qua URI file:, nó đọc được mọi file mà tài khoản đang chạy đọc được. Kết quả in ra màn hình hoặc ghi vào file bạn chọn bằng -o. Không ghi file cấu hình.
- Gọi mạng
- Tải mọi URL http/https bạn đưa vào. Link YouTube thì lấy phụ đề từ youtube.com. File âm thanh (wav, mp3, mp4…) được gửi lên dịch vụ nhận giọng nói của Google khi cài bản [all]. Azure và LLM chỉ được gọi khi bạn cấu hình khóa.
- Script lúc cài
- Cài từ PyPI dạng gói Python (hatchling), không có bước chạy script lúc cài. Gói lõi kéo theo magika (nhận dạng loại file, chạy trên máy bằng onnxruntime).
- Tiến trình
- Gọi chương trình exiftool nếu tìm thấy trên máy, để đọc metadata ảnh và âm thanh. Bản MCP chạy một tiến trình Python qua stdio, hoặc mở HTTP ở 127.0.0.1:3001 khi thêm --http; server này không có đăng nhập. Đây là MCP server của bên thứ ba: nó chạy code với quyền của tài khoản bạn.
Đọc từ: _markitdown.py#L479-L540, _transcribe_audio.py#L59, _youtube_converter.py, _exiftool.py, pyproject.toml, __main__.py, README.md#security-considerations
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin